This allows you to define additional email addresses here (one per line) that should receive sale notifications anytime a product is sold.

The post Per Product Notifications first appeared on Easy Digital Downloads.

Note: EDD Favorites requires the EDD Wish Lists extension to be installed and activated.

Setup

After you have installed and activated the EDD Favorites extension, you can find the settings area by navigating to Downloads → Settings → Main.

Favorites Page: This is the page where users will view their Favorites. It can be any page of your choosing as long as it contains the [edd_favorites] shortcode.

Favorites Edit Page: This is the page where users will be able to edit their Favorites List. It can be any page of your choosing as long as it contains the [edd_favorites_edit] shortcode.

Favorites Text: This is the text that will display on the front-end of the website on each Download to allow the user to add it to their Favorites.

Usage

Once activated, the Favorites buttons will show by default on all Downloads.

Note: The button appearance along with the icon are determined through the EDD Wish Lists settings area.

Once an item as been added as a Favorite it will be available through the “Favorites” page that is set in the general settings area mentioned above.

From this screen, the user can add the Favorite item to their cart, remove the Favorite, as well as navigate to their Favorites settings area by clicking “Edit Settings”

This page is available through the “Edit Settings” link on the Favorites page, and this is the same area the user will see if visiting the “Favorites Edit Page” that’s setup through the general settings mentioned above.

From this page the user has the ability to rename their Favorites list, add a description, choose whether the list is public or private, as well as delete their favorites if needed.

The post EDD Favorites first appeared on Easy Digital Downloads.

Configuring Purchase Gravatars

After the extension has been installed and activated go to WordPress admin → Downloads → Settings → Extensions → Purchase Gravatars and configure the display settings.

Next you’ll go to WordPress admin → Downloads → All Downloads and select the Download(s) you want your customers Gravatars to be displayed for.

Add the [edd_purchase_gravatars] shortcode to the product description text box and click Update.

Alternately you can use the EDD Purchase Gravatars widget to display the images.

The post EDD Purchase Gravatars first appeared on Easy Digital Downloads.

Vendor Dashboard Instructions

Vendors (from Frontend Submissions) can deliver customized files to their customers.

Instructions for Vendors:

1. Log into the Vendor Dashboard
2. Click on “Orders”.
3. Find the order in question and click “View”.
4. Under “Custom Deliverables”, upload the file you’ve customized for the customer.
5. Click “Save Custom Deliverables”.
6. Use the “Notify Customer” tool to send an email to the customer, notifying them that their files are ready to download.

The post Custom Deliverables – Frontend Submissions Integration first appeared on Easy Digital Downloads.

Does Simple Shipping integrate with my preferred shipping company?

No, Simple Shipping doesn’t integrate with any shipping company. It simply collects the shipping location address and then the store owner is responsible for all shipping details.

Can I have variable shipping costs by weight?

No, Simple Shipping is flat rate only.

Can I have variable shipping costs by size?

No, Simple Shipping has no mechanism for dealing with product size.

Can I have variable shipping costs by distance?

No, Simple Shipping is flat rate only (other than a separate rate for “Domestic” or “International”).

Can I charge a different rate for domestic and international shipping?

Yes, a single flat rate for domestic and a single flat rate for international.

Can Vendors set Shipping rates through Front End Submissions?

Yes. Read more in the Frontend Submissions Integration Guide.

Are shipping fees included in tax?

No.

Can products be “combined” so they are shipped in the same package?

No. This is something that has been discussed but decided it won’t be a feature that ever gets added to the Simple Shipping extension. That feature is what would take it from being a “Simple” shipping plugin to being a “Complicated” shipping plugin – and we want it to remain “Simple” to set up and use. The amount of scenarios that would need to be considered are absolutely enormous.

For a hypothetical example, you could have a car and a microwave being shipped in the same purchase. While they could fit into a very large box together, you wouldn’t necessarily just throw them into the same box. You’d need to make sure both were secure – and shipping a microwave with a car is very different from shipping one on its own. Additionally, the plugin wouldn’t know that a car is very heavy unless we also added a “weight” setting (one more level of complication for the user). We would then need to give you options to say that “if an object is heavier than X, it can’t be shipped with other items”.

Now instead, say the person was buying a microwave and a pair of headphones. They might fit into the same box and probably not increase the cost of shipping (over the cost of shipping the microwave). But say instead of buying headphones they bought a heavy brick (maybe they are collectors of bricks) the same size and shape as the headphone box. This would cost more to ship because it is heavier. The system would now need to add up the weight of the brick and the microwave to do a proper estimate of the cost of shipping the items together.

Now consider the size and shape of items as well. Say the user was buying headphones and a 2x4x8 piece of wood. These would not make sense to ship together since one is very long and the other is not. They would not simply fit into the same box easily – unless you defined the size and shape of boxes that you have “on-hand” as the shipper. This would then add more complication as you would need to enter all of your box-size possibilities.

Then there are also items that don’t have a solid width or height – like tshirts. You could fit 1 shirt into an envelope. You might even be able to fit 4 shirts into an envelope. But how do you know when you can’t fit any more shirts into an envelope? The system isn’t able to guess this and would require you to define “flexible” packaging (like envelopes that can “flex” in size) – but then let it know when to “max out”. You’d have to say “the envelope can only hold 4 shirts but not 5”. How you would say that would require a plethora of new options that would be difficult to understand.

Now imagine the person is buying 5 t-shirts and 16 pieces of paper. How many of those things combined could fit into a single envelope? Defining the way those combine becomes doubly as complex. As you add more and more different types of products, the complications increase exponentially.

The post Simple Shipping FAQ first appeared on Easy Digital Downloads.

After installing and activating EDD Compare Products, a new button will be added to each item listed using the [downloads] shortcode. It will look something like this:

As you can see in the above screenshot, a new button is added for each item which, when clicked, adds the item to the list of items to compare. This list can be viewed by clicking on the “View Comparison” button (seen below). Any number of items can be added to the comparison at one time.

Configuration

To configure this extension, navigate to Downloads > Settings > Extensions > Compare Products. In this settings area, you’ll have several options to configure.

Default Comparison Page: This is the page that users will be directed to when clicking through to view comparisons. This page must contain the [edd_compare_products] shortcode.

Default Downloads: These are default download IDs that can be set by the site owner.

Default Table Style: This is the layout of the comparison table. The only available option at this time is for a horizontal scroll.

Meta Fields: Default meta fields can be defined here. Any custom meta fields attached to a download will also appear as selections in this area.

Compare Button Text: This allows you to set a custom label for the Compare button.

Go Button Text: This allows you to set a custom label for the button used to view comparisons.

Viewing Comparisons

When someone selects products to compare and visits the comparison page, they will see the products listed side by side like so:

The post Compare Products first appeared on Easy Digital Downloads.

Configure the Terms Per Product

Once this extension is installed and activated, go to WordPress admin → Downloads → All Downloads and select the Download(s) you wish to add your per product terms to. Within the Download Settings menu on the right you will see a Download Terms of Use box.

Once you’ve entered the terms specific to this Download click Update.

The terms specific to that product will then be displayed on the checkout page along with an Agree to Terms checkbox whenever a customer adds this product to their shopping cart and proceeds to checkout. If a customer purchases more than one item with unique terms multiple terms and checkboxes will be displayed at checkout.

The post Terms Per Product first appeared on Easy Digital Downloads.

Table of Contents

• Settings
• Templates
• Filters
• Shortcodes
• Troubleshooting

Settings

Once the Recommended Products extension is installed and activated, you can navigate to Downloads → Settings → Extensions → Recommended Products. Here you will have the ability to choose from several options on how you want the extension to function.

Show on Downloads – Checking this box will make the recommended products display on individual product pages.

Show on Checkout – Checking this box will make the recommended products display on the checkout screen.

Number of Recommendations – Determines how many recommended products are shown.

Show Free Products – Checking this box will allow free products to be included in the recommendations. By default free products are excluded.

Templates

Recommended Products includes two template files that can be customized by copying them to your theme’s edd_templates directory, as shown in the Moving EDD templates to your theme documentation.

To use the template files, copy the files from /
edd-recommended-products/templates/ to /wp-content/themes/YOURTHEME/edd_templates/ and then modify as desired.

Single Item Recommendations:

To get the recommendations for a single page (single.php download post type), use the supplied single_recommendations.php template as a guide to isolate the recommendations for this specific item. If desired, you can also supply the logged in user ID as a 2nd argument to
edd_rp_get_suggestions() to remove items the current user already owns. In the default template this is not enabled, and users will see items they have purchased in the Single view.

Checkout Page Recommendations:

This page uses all items currently in the cart to build a recommendation profile. You can use the supplied checkout_recommendations.php template as a guide to get the recommendations profile, and if desired specify the currently logged in user ID as a 2nd argument to
edd_rp_get_multi_suggestions() to remove items the current user already owns. In the default template this is enabled to prevent a user from buying items again, since they are 1 step away from final checkout.

Filters

Recommended Products includes several filters that can be used to adjust the extension’s behavior. These filters are for developers who are familiar with WordPress Hooks and Filters.

• edd_rp_log_query_args – Alter the number of logs used to determine recommendations (default is 250).
• edd_rp_single_recommendation_count – Alter the number of recommendations for a single product.
• edd_rp_single_recommendation_results – Allows you to filter the recommendations for a single product.
• edd_rp_multi_recommendation_count – Alter the number of recommendations for the multi product view
• edd_rp_multi_recommendation_results – Allows you to filter the recommendations for the multi product view
• edd_rp_suggestion_counts – Add items to the recommendations count dropdown.
• edd_checkout_image_size – Image size used for post images in the default recommendations templates.
• edd_recommended_products_languages_directory – Alter the location for language translations
• plugin_locale – Alter the locale being used.

Shortcodes

Recommended Products, includes a shortcode to allow for the recommendations to be placed within page/post content as you’d like. An example of this shortcode is:

[recommended_products ids="24, 41" count="10" title="We Also Recommend"]

The list of attributes (and their defaults) are:

• ids: a comma separated list of Download IDs to provide suggestions for (default: current post ID)
• user: “true” or “false”, whether to hide already purchased items from displaying (default: false)
• count: number of suggestions to show (default: 3)
• title: A title to display (default: “Recommended Products”)

Troubleshotting

Occasionally you may find that you have no recommendations. Below are some common reasons.

Reason 1: Not Enough Data

Recommended Products analyzes the last 250 purchases on the site (every night) and, based on those purchases, suggests other products that users have also purchased. This means that if your store is quite new, has been recently reset, or has very few transactions, you may not see any recommendations right away.

Reason 2: Already Purchased

On the checkout page, if the user is logged in and already owns a product, that product won’t be recommended to them, even if it met criteria to be recommended. This makes room for other products that the customer may be interested in buying.

Reason 3: Lack of Theme Support

Some themes simply choose not to render the Recommended Products on the Checkout page.

More generally, the Recommended Products extension relies on some hooks provided in the default EDD templates. If those templates are edited and/or those hooks are removed, no recommendations will be printed.

The post Recommended Products Intro and Settings first appeared on Easy Digital Downloads.

All files uploaded by Vendors will be automatically placed in the default bucket you have selected in the Amazon S3 settings. Within the default bucket, a folder with the Username or User ID of the Vendor will contain that Vendor’s files.

Folder Name Setting

This setting is added to the Amazon S3 Settings upon installing the Amazon S3 Extension. This setting determines the naming convention of the folder each Vendor’s files are placed in.

Prices and Files Form

When Amazon S3 and Frontend Submissions are both installed, files that are uploaded by Vendors (via the “Download Prices and Files” field on the “Add/Edit Product” page in their Vendor Dashboard) will be automatically transferred to your S3 account. There are no additional settings to configure; it’s all automatic.

Amazon S3 Uploader

This is used specifically for uploading files only accessible via the WordPress admin, which are found in the Download settings area when creating/editing a Download.

Notes:

• Files are all uploaded to the same bucket
• Files uploaded to Amazon S3 do not get stored in your local media library
• Only files uploaded through the Download Prices and Files field are uploaded to Amazon S3

The post Amazon S3 and Frontend Submissions first appeared on Easy Digital Downloads.

Setup

After you have installed and activated the Download Email Attachments extension, you can find the settings area by navigating to Downloads → Settings → Extensions.

The only option is to enable the functionality on a per download basis. If this option is not enabled then all downloads will have email attachments in place for the file downloads.

If the above option is enabled, then each download will have an option to enable this functionality, and it will be located in the “Download Prices” area when creating or editing a download product.

NOTE: Pay special attention to the size of your download attachments. This extension is great for sending files as attachments, but a large file over 10mb may not reach a customer’s inbox. Some customers may have the maximum size for an email set even lower. Also note that this plugin does not remove download links from the purchase confirmation page (this can be done by editing the shortcode-receipt page) or the purchase confirmation receipt (you can remove download links from the email in Downloads → Settings → Emails → Purchase Receipts).

The post Download Email Attachments first appeared on Easy Digital Downloads.

Setup

Once installed and activated there are no settings to configure, the functionality is immediately available.

Usage

When installed this extension will add a “Duplicate” link in addition to the other links below the title of each of your Download posts. You can see these links by hovering over a Download title when navigating to Downloads → All Downloads.

When you click the “Duplicate” link the details of a product are copied to a new draft. This is extremely useful for variation products, because the variations do not need to be re-created for every single product.

If you need to duplicate a large number of Downloads, it may be best to bulk import products from CSV. This is useful for importing many products at once which might be more suitable than duplicating and modifying Downloads one at a time.

Note: There are many plugins available for duplicating posts. Some of them will copy over sales counts and earning stats which will likely lead to problems with your store. Additionally, many of these plugins do not have the programming in place to duplicate all of our custom metadata.

The post Duplicate Downloads first appeared on Easy Digital Downloads.

The Custom Deliverables extension for Easy Digital Downloads makes it possible to attach customized files to a customer’s order. The customer can log into their account at any time to download those files. The files are protected and tracked by the same system that protects normal deliverable files in Easy Digital Downloads.

Initial Setup:

Once activated, there are no settings to configure. In all Order Details (Downloads → Orders → Order Details) a Custom Deliverables section will appear where you can upload and notify customers that custom file(s) are available for download.

Attaching and delivering customized files to an order/payment

Within the Custom Deliverables section, you can Upload a File the same way you add files to a product.

(Optional) You can also choose which group(s) of files you want the customer to have access to. You can choose either default files only, customized files only, or both default and customized files.

• Default files are the files attached to the product by default when the product was first created and added to the store.
• Custom files are the files attached only to the payment in question.

You can also click to mark each product in the order (or “job”) as fulfilled. Once all jobs are marked as fullfilled, the payment will show as fulfilled under Dashboard → Downloads → Orders.

Click Notify Customer to notify customers their file is available for download.

Edit Notify Customer Email

You can edit the Notify Customer email under Downloads > Emails > Custom File Delivery.

Custom Deliverables – FAQ and Troubleshooting

How can I require that the customer be logged in to download customized files?

If you want to require that the customer be logged into your website in order to download their customized files, you can use this code snippet: http://library.easydigitaldownloads.com/misc/restrict-downloads-to-purchase-email.html

The best way to apply the code snippet to your site is to create a new custom plugin. To do that, install the free plugin called Pluginception, https://wordpress.org/plugins/pluginception/, and use it to create a new custom plugin. Name the plugin something appropriate and then paste the provided code snippet into it and activate the plugin.

For Vendors in Frontend Submissions, why isn’t the “Upload Files” button working for Custom Deliverables?

Double check that you have set up the Vendor Dashboard correctly. Go to Dashboard → EDD FES → Settings → Forms/Pages → Vendor Dashboard Page and make sure you have selected the correct page. This will solve the issue.

The post Custom Deliverables – Overview first appeared on Easy Digital Downloads.

Once the QR Codes extension is installed and activated, you can configure through the creation or edit screen of a Download.

When editing or creating a Download, you will see a “QR Code” section in the right sidebar area:

You have the ability to create a QR code that will add the product to the cart when someone uses it, or just point to the page containing the Download/Product. Select your choice and click the “Generate” button to show the QR code, a URL and download the image if needed.

The post QR Codes first appeared on Easy Digital Downloads.

Adding shipping to the submission form

To allow Vendors to set their own shipping rates on their products, edit the Submission Form and add the “Shipping” field which can be found under Add Extension Created Fields. When this is in place, vendors who edit products will see two fields: Domestic and International shipping rates.

Basing shipping costs on vendor location

Simple Shipping includes a setting for defining the base country of a digital store. This country will be used to determine whether the International or Domestic rate will apply when customers enter their shipping address during checkout. When using Simple Shipping with Frontend Submissions, typically the vendors will be the one handling the shipping and therefore it is necessary to base the country on the vendor’s location rather than the store owner’s.

To change the shipping calculation to use the Vendor’s location instead of the store’s, a new “Country” field must be added to the Vendor profile form. This field must use the Meta Key “vendor_country” to work correctly. Once this field is in place and a Vendor has set their country, customers purchasing products from the Vendor will have shipping costs added based upon that Vendor’s country instead of the main store’s country.

The post Integration Guide: Frontend Submissions and Simple Shipping first appeared on Easy Digital Downloads.

Setup

After you have installed and activated the List File Names extension, there is no setup process and the functionality is immediately available.

Standard Usage

Adding the [edd_file_names] shortcode to the product description will create a list of the file’s names as shown under the Download File section.

The placement of the shortcode determines where the list of file names will appear. Below is an example of the description area when creating/editing a Download.

When viewed on the front-end of the site, the download description will display as well as a list of names of any files attached to the Download based on the location of the shortcode.

Usage on other Pages/Posts

The [edd_file_names] shortcode also accepts two parameters:

• Title
• ID

When using the “ID”, you are able to show the file name(s) from a Download on other pages or posts instead of on the Download itself. This can be useful when referencing Downloads on other areas of the site. The “title” allows for a custom title to be added. This is an example of a WordPress page using the ID and Title parameters.

The front-end display of the page will show the file name based on the ID provided as well as the custom title.

The post List File Names first appeared on Easy Digital Downloads.

1. Configure the Digital Badge extension

Once this extension is installed and activated, go to WordPress admin → Downloads → Settings → Extensions → Digital Badge Settings to configure the text that will be displayed to your customers.

2. Enable Digital Badges per Download

Once you’ve entered the Download Badge Text, the Product Badges box will need to be checked for each applicable Download. The Product Badges checkbox is located in the Download Settings menu on the right side of your screen when viewing a Download.

After checking the Product Badges box click Update to save your changes and display the badge.

The post Configuring the Digital Badge extension first appeared on Easy Digital Downloads.

Adding New Conditional Success Redirect

Editing a Conditional Success Redirect

Important Note

The post Conditional Success Redirects Documentation first appeared on Easy Digital Downloads.

Table of Contents

• Setup & Usage
• List Management
• Templates
• Modifications

The Wish Lists extension for Easy Digital Downloads gives customers the ability to save and share their favorite products on your site.

Setup

After you have installed and activated the Wish Lists extension, you can find the settings area by navigating to Downloads → Settings → Extensions → Wish Lists.

Wish Lists Page: This is the page where users will view their own wish lists. This page must include the [edd_wish_lists] shortcode.

Wish Lists View Page: This is the page where users will view each wish list. This page must include the [edd_wish_lists_view] shortcode.

Wish Lists Edit Page: This is the page where users will edit a wish list that they own. This page must include the [edd_wish_lists_edit] shortcode.

Wish Lists Create Page: This is the page where users will create a wish list. This page must include the [edd_wish_lists_create] shortcode.

Add To Wish List Text: This is the text that will appear on the button or link to indicate the customer can click to add the item. The default is “Add to wish list“.

Add To Cart Text: When looking at a Wish List, each item has a button to allow adding that item to the cart. This field allows the store owner to indicate what text should be used. The default is “Add to cart”.

Allow Guests To Create Wish Lists: Choose whether guests (non logged in users) can create Wish Lists. If no, then only registered users can create wish lists.

Icon: The “Add” button may use a selection of different icons in addition to the “Add” text including a plus sign, bookmark, gift, heart, star or no icon.

Button Style: Choose whether the “Add” mechanism will be a button or a link.

Sharing: Customers with Wish Lists may share their lists through the following platforms:

• Twitter
• Facebook
• Google+
• LinkedIn
• Email

Usage

Once setup, each product will have a link or button (store owner’s choice) that communicates to the customer that they can add the product to a wish list.

Once that button/link is clicked, a modal window appears asking the customer to either add the item to an existing list or create a new list.

If selecting “Add to new”, the user will be presented with the option to name the list as well as choose whether the list is Public or Private (only viewable by the user).

List Management

Wish List Page

The main Wish list management page shows only content related to the customer currently logged in, or the customer that created lists in the current session. It offers a button to create a new list, and then shows each list created by the customer.

Creating a List

When on the main Wish List management page, the customer may click the Create new wish list button. This will take the customer to a new page where they will be asked for a List Name, List Description, and have the option of making the list Public or Private.

The customer may also create a new list immediately after clicking an Add to wish list button or link from the main store listings page.

Editing a List

When on the main Wish List page, on the right of every list is an edit link.

Clicking that link will take the customer to a page where they can rename the list, change the description, change its visibility permissions, or delete the list.

Deleting a List

The edit screen also has a Delete wish list link, as seen in the screenshot immediately above. Clicking it will bring up a modal window, asking the customer if they’re sure they want to delete the list.

Once the customer confirms the deletion, the list is removed. The customer is returned to the main Wish List management page and a message is displayed indicating that the list has been deleted.

Templates

EDD Wish Lists has 4 templates you can edit, located in the plugin’s templates folder, just like EDD. Copy each template into your child theme’s edd_templates folder and edit accordingly.

Note: Do not edit the templates in the plugin folder as your modifications will be lost when the plugin is updated.

Click here to read documentation on how to properly move templates.

1. wish-lists.php
   The main wish lists page where users view all of their lists.
2. wish-list-view.php
   The page where users view/share an individual wish list.
3. wish-list-edit.php
   The form for editing a wish list
4. wish-list-create.php
   The form for creating a wish list.

Modifications

Changing the default labels

By default, the standard singular label in the Wish Lists extension is “Wish List” and the plural is “Wish Lists”. You might want to change these labels to better represent your website.

The example below shows how you can change both the singular and plural labels to “Light Box” and “Light Boxes” – Perfect if you sell stock photography.

Modifying the default message

It’s possible to change the default messages that appear throughout EDD Wish Lists.

Copy and paste the following function (mind the opening PHP tag) into your child theme’s functions.php or custom plugin and modify each of the messages accordingly.

 <?php

function sumobi_edd_wl_messages( $messages ) {

	$messages = array(
		'must_login'                   => sprintf( __( 'Sorry, you must login to create a %s', 'edd-wish-lists' ), edd_wl_get_label_singular( true ) ),
		'list_updated'                 => sprintf( __( '%s updated', 'edd-wish-lists' ), edd_wl_get_label_singular() ),
		'list_created_guest'           => sprintf( __( '%s created and saved for 30 days. If you wish to keep it longer, please create an account.', 'edd-wish-lists' ), edd_wl_get_label_singular() ),
		'list_created'                 => sprintf( __( '%s created', 'edd-wish-lists' ), edd_wl_get_label_singular() ),
		'list_deleted'                 => sprintf( __( '%s deleted', 'edd-wish-lists' ), edd_wl_get_label_singular() ),
		'no_lists'                     => sprintf( __( 'You currently have no %s', 'edd-wish-lists' ), edd_wl_get_label_plural( true ) ),
		'list_delete_confirm'          => sprintf( __( 'You are about to delete this %s, are you sure?', 'edd-wish-lists' ), edd_wl_get_label_singular( true ) ),
		'no_downloads'                 => sprintf( __( 'Nothing here yet, how about adding some %s?', 'edd-wish-lists' ), edd_get_label_plural( true ) ),
		'lists_included'               => __( 'This item has already been added to: ', 'edd-wish-lists' ),
		'modal_option_save'	           => __( 'Save', 'edd-wish-lists' ),
		'modal_option_close'           => __( 'Great, I'm done', 'edd-wish-lists' ),
		'modal_option_add_new'         => __( 'Add to new', 'edd-wish-lists' ),
		'modal_option_add_to_existing' => __( 'Add to existing', 'edd-wish-lists' ),
		'modal_option_title'           => __( 'Title', 'edd-wish-lists' ),
		'modal_delete_title'           => sprintf( __( 'Delete %s', 'edd-wish-lists' ), edd_wl_get_label_singular( true ) ),
		'modal_button_delete_confirm'  => sprintf( __( 'Yes, delete this %s', 'edd-wish-lists' ), edd_wl_get_label_singular( true ) ),
		'modal_share_title'	           => sprintf( __( 'Share this %s', 'edd-wish-lists' ), edd_wl_get_label_singular( true ) ),
		'modal_share_success'          => __( 'Successfully shared', 'edd-wish-lists' ),
		'list_option_private'          => __( 'Private - only viewable by you', 'edd-wish-lists' ),
		'list_option_public'           => __( 'Public - viewable by anyone', 'edd-wish-lists' ),
		'list_title_required'          => __( 'You need to enter a title', 'edd-wish-lists' ),
		'item_already_purchased'       => __( 'Already purchased', 'edd-wish-lists' ),
	);

    return $messages;
}
add_filter( 'edd_wl_messages', 'sumobi_edd_wl_messages' );

Change the icon’s position

In the Wish Lists addon here’s how you can globally change the icon’s position to appear to the right of the text on all add-to wish list links.

Move the wish list button to the download details widget in the Marketify theme

If you’re using the Marketify theme with EDD Wish Lists there’s a way to move the “add to wish list” button from it’s default location, and position it inside EDD’s “Download Details” widget.

This is the widget you’ll end up with, which you can now freely position within your sidebar.

Drag the “Download Details” widget into the “Download Single Sidebar” widget area where you’d like it to appear. Clear out all the options if you don’t need them.

That’s it!

The post EDD Wish Lists first appeared on Easy Digital Downloads.

Once installed and activated, you will see the Hide Download options area when creating or editing a download. The options are located in the Download Settings area in the right column of the create/edit screen of a Download.

The two options available are:

Hide this download – This hides the download from the Downloads archive page which is typically located at http://your-site.com/downloads

Disable direct access to this download – This removes access to the download. In the event a user was to enter the direct URL of the download, it will not be available.

This extension can be useful if you want to remove a download from the archive page and specifically highlight it elsewhere on your site using the [purchase_link] shortcode or a custom link.

The post Hide Download first appeared on Easy Digital Downloads.

Create Per Product Emails

Once installed and activated, navigate to Downloads > Emails, click Add New Email and select Per Product Email.

This will open the email editor to create your Per Product email, for the selected Download.

Enable the email at the top and click Save.

View & Edit existing Per Product Emails

Once you have a custom email configured, you’ll be able to see it in the list of emails under Downloads > Emails. You can use the Senders filter to only display Per Product Emails. You are able to click the email to open the editor or toggle the Status to disable or enable.

Common Issues and FAQ

Product Variations

This extension does not support sending unique emails for product variations at this time.

Original Purchase Receipts

Easy Digital Downloads will send a purchase receipt as well as a custom email when Per Product Emails is active on a specific Download. You can disable the default Purchase Receipt under Downloads > Emails.

Multiple Downloads in the cart

Once custom emails have been configured, it will send a custom email for each item in the cart. For example, if you have configured emails for Product A and Product B and someone purchases both in the same transaction, the extension will send two custom emails – one for each product

The post Per Product Emails Documentation first appeared on Easy Digital Downloads.

Settings Area:

By navigating to Downloads → Settings → Extensions you will have the ability to select Download categories that are “services”.

If a download belongs to one of the categories selected, then the Purchase Confirmation page will not show the “no downloadable files” message for that particular download.

Settings Per Download:

When creating or editing a Download product, you will see a new area in the right column in the Download Settings area which will allow you to set the individual Download as a “service”.

If this setting is active, then the Purchase Confirmation page will not show the “no downloadable files” message for that particular download.

The post Downloads as Services first appeared on Easy Digital Downloads.

Table of Contents

• Creating Cross-sells & Upsells
• Settings
• Removing the Excerpt
• Unhook Upsells From a Single Product Page
• Moving Cross-sells Above Product Listing on Checkout
• Custom Headings
• Remove the Stylesheet
• Filtering Products in the Admin

Creating Cross-sells and Upsells

With the
EDD Cross-sells and Upsell extension, creating either a cross-sell or upsell is easy and intuitive. Follow the steps below to setup your Cross-sells/Upsells.

1. Visit the download in the WordPress admin that you would like to add cross-sells/upsells for
2. Scroll down to the new Cross-Sell & Upsell metabox area
3. Set specific headings if necessary, otherwise the headings from the main settings area will be used.
4. Click into the provided fields, and select your desired products that will be the Cross-sell or Upsell item(s)
5. Save

Cross-sells will be shown on the checkout page, and upsells will be shown on the individual product page.

Cross-sell & Upsell Settings

Once installed and activated, a new EDD Cross-sell Upsell Settings section will appear when navigating to Downloads → Settings → Extensions → Cross-sell & Upsell.

Default Upsell Heading

This is the default heading shown on single product pages. Headings are also customizable on a per-product basis from each individual product page.

Default Cross-sell Heading

This is the default heading shown at checkout for Cross-sell products. Headings are also customizable on a per-product basis from each individual product page. If multiple cross-sells are shown from different products, then the default heading is used.

Maximum Upsells To Show

This is the maximum number of upsells that will be shown on a single product page

Maximum Cross-sells To Show

This is the maximum of upsells that will be shown on a single product page

Removing the Excerpt

To remove the excerpt using the
Cross-sells and Upsells addon, copy and paste one of the following functions (mind the opening PHP tag, as it’s not needed if code is being added to existing PHP file) into your child theme’s functions.php or a custom plugin.

This example shows how you can remove the excerpt.

	/**
	 * EDD Cross-sell & Upsell - Removing the excerpt
	 * https://easydigitaldownloads.com/extensions/cross-sell-and-upsell/?ref=166
	*/
	function sumobi_edd_csau_show_excerpt() {
		return false;
	}
	add_filter( 'edd_csau_show_excerpt', 'sumobi_edd_csau_show_excerpt' );

This example shows how you can remove the excerpt, but only on single download pages.

	/**
	 * EDD Cross-sell & Upsell - Removing the excerpt, but only on single download pages
	 * https://easydigitaldownloads.com/extensions/cross-sell-and-upsell/?ref=166
	*/
	function sumobi_edd_csau_show_excerpt() {
		if ( is_singular( 'download' ) ) {
			return false;
		}

		return true;
	}
	add_filter( 'edd_csau_show_excerpt', 'sumobi_edd_csau_show_excerpt' );

Unhook Upsells From a Single Product Page

With Cross-sells and Upsells, if you want to remove the upsells from displaying after the content, you can use the filter below.

You may wish to do this if you wanted to re-hook the upsells onto another action hook.

	remove_filter( 'the_content', 'edd_csau_single_download_upsells', 100 );

Move Cross-sells About Product Listing on Checkout

By default with the Cross-sells and Upsells addon, the Cross-sells are shown just below the product listing on the checkout page. If you would like them to appear above the product listing you can paste the following code into your theme’s functions.php:

	function sumobi_edd_csau_move_cross_sells_at_checkout() {
	    // remove cross-sells from after the product listing at checkout
	    remove_action( 'edd_after_checkout_cart', 'edd_csau_display_on_checkout_page' );

	    // add the cross-sells before the product listing at checkout
	    add_action( 'edd_before_checkout_cart', 'edd_csau_display_on_checkout_page' );
	}
	add_action( 'template_redirect', 'sumobi_edd_csau_move_cross_sells_at_checkout' );

Custom Headings

Custom headings on your Cross-sells and Upsells are a great way to not only increase sales but build customer relationships.

Upsell Heading

In the Settings for Cross-sells and Upsells, you can set a default Upsell heading. You can further enhance the power of this extension by making custom headings for specific Downloads. Each Download has a metabox for managing the heading.

In the referenced metabox above, you have the ability to set a custom heading that is shown above the upsell products on the individual product page. This is perfect for creating a more personal message that relates to the products being offered.

Cross-sell Heading

The custom Cross-sell heading is shown on the checkout page. If your customer has a song (by their favorite music artist for example) in their shopping cart, you could offer more songs from that artist as a cross-sell.

If the customer happens to have something completely unrelated in their cart which also triggers a cross-sell product, the fallback heading is shown (this is set by navigating to Downloads → Settings → Extensions → Cross-sell & Upsells)

Remove the Stylesheet

The Cross-sells and Upsells addon comes with styles that affect the output of the suggested downloads.

You can remove the stylesheet that the extension loads by adding the below code to your theme’s functions.php file or through a custom plugin.

	function sumobi_edd_csau_deregister_styles() {
		wp_deregister_style( 'edd-csau-css' );
	}
	add_action( 'wp_enqueue_scripts', 'sumobi_edd_csau_deregister_styles', 20 );

Filtering Products in the Admin

With the Cross-sells and Upsells addon, products can be filtered in the WordPress admin on the main Downloads page via the dropdown menus above the downloads. A new dropdown menu will be added where you can quickly show:

• Downloads with cross-sells
• Downloads with upsells
• Downloads with both cross-sells and upsells

Combined with the standard WordPress filter options, it’s a powerful way to quickly find all your downloads with cross-sells and upsells.

The post Creating Cross-sells and Upsells first appeared on Easy Digital Downloads.

Initial Setup:

Once you’ve purchased and installed the Simple Shipping extension, in the WordPress admin go to: Downloads > Settings > Extensions > Simple Shipping

There, you’ll need to choose a Base Region and choose whether to apply tax to shipping fees. The Base Region setting will let Simple Shipping know whether an order is “Domestic” or “International” when applying the shipping fee to an order.

Creating a Shipping-Enabled product.

To enable shipping for a product, while creating or editing that product look for the “Download Prices” section. When you check the “Enable Shipping” checkbox, you can set a flat rate for both Domestic and International shipping.

Note: Domestic means that the customer is in your store’s country. International means the customer is not in your store’s country.

If you have enabled variable pricing, you can also set up different shipping rates for each variation of a product. For example, a “Small (Option 1)” version can have different shipping rates than a “Large (Option 2)” version. Click “Show advanced settings” to enter the Simple Shipping Settings.

Shipping your orders

Once you receive an order for a shipping enabled product, you need to handle the actual shipping. To do that, you need the customer’s address so you can put it on the package you are shipping. All of the information for shipping can be found on the Payment’s “Order Details” page. Find this by navigating to:
Downloads → Orders → Find the order → click “View Order Details”

On the Order Details page, find the section called “Shipping Address”. This contains the address the customer entered upon checkout. You will use this information to send the package to the customer.

Once you’ve shipped the item, check the box called “Check if this purchase has been shipped”. This is an easy way to remember whether or not an order has been shipped or not. Then, when looking through your orders on the “Orders” page, the “Shipped” column will indicate if an order has been shipped or not:

Tracking Numbers

If you wish to provide a tracking number to your customers, once you’ve shipped the item and have the tracking number from your shipping company, enter it into the box called “Tracking Info” on the Order Details page. Then, click “Save Payment” to update it. After it is saved, you will see the “Track Parcel” option and also the “Send Tracking Info” option. This will send an email to the customer with the tracking information.

Simple Shipping Emails

Customer tracking emails

You can customize the email sent to your customer when you click the “Send Tracking Info” button. The controls for this can be found in your WordPress Dashboard by navigating to:
Downloads > Emails > Order Shipping Notification

Clicking the Order Shipping Notification opens the editor:

By including template tags in the email, they will be replaced with the actual information relating to this order. You can click the Insert Tag button to open the list of available tags, which you can click to insert into the email. The following template tags can be used for this email:

{download_list} – A list of download links for each download purchased {file_urls} – A plain-text list of download URLs for each download purchased

{name} – The buyer’s first name

{fullname} – The buyer’s full name, first and last

{username} – The buyer’s user name on the site, if they registered an account

{user_email} – The buyer’s email address

{billing_address} – The buyer’s billing address

{date} – The date of the purchase

{subtotal} – The price of the purchase before taxes

{tax} – The taxed amount of the purchase

{price} – The total price of the purchase

{payment_id} – The unique ID number for this purchase

{receipt_id} – The unique ID number for this purchase receipt

{payment_method} – The method of payment used for this purchase

{sitename} – Your site name

{receipt_link} – Adds a link so users can view their receipt directly on your website if they are unable to view it in the browser correctly.

{discount_codes} – Adds a list of any discount codes applied to this purchase

{ip_address} – The buyer’s IP Address

{tracking_ids} – Show saved tracking ids for payment.

New Sale Notifications

If an order includes a product with shipping enabled, the customer’s shipping information will be automatically appended to the New Sale Notification email. No customization is necessary to include this information.

Integrations

Frontend Submissions: Simple Shipping is compatible with Frontend Submissions.

Commissions: You can split shipping fees so they are paid to specific commissions receivers. See the full documentation for Shipping and Commissions integration.

Alternatives

Note that this plugin is meant to be very simple and does have limitations on how complex its shipping options are. If you need more robust/complex shipping options, it may be wise to look at other eCommerce solutions. Here are some we recommend:

• WP eCommerce
• iThemes Exchange
• Shopp
• WooCommerce

The post Simple Shipping Setup first appeared on Easy Digital Downloads.

Connecting to BitBucket

To connect your Easy Digital Downloads website to your Bitbucket account, you will need to create an APP inside your Bitbucket account and then add the APP Password and your Bitbucket username in the extension’s settings.

To create an app password follow the steps below:

1. From the top right cog wheel icon, select Personal Bitbucket Settings.
2. Select App passwords under Access management.
3. Select Create app password.
4. Give the app password a name that will help you remember what it’s used for.
5. In the Permissions section check the boxes for:
   • Account > Email and Read
   • Workspace Membership > Read
   • Projects > Read
   • Repositories > Read
6. Copy the generated password in a safe place for now. The password is only displayed this one time.

Here is an image of all the required permissions described at step 5 above:

More details on app passwords (including usage and revocation) can be found in the Bitbucket documentation.

Once you have the new app password add it to the Downloads > Settings > Extensions > Git Updater page.

The Username field is your actual Bitbucket username (do not confuse this with the account email). You can easily find it on this page: https://bitbucket.org/account/settings/ under the “Bitbucket profile settings” section.

Connecting to GitHub

To use GitHub, navigate to Downloads > Settings > Extensions > Git Updater. Follow the instructions there to connect to GitHub.

Configuring a Download with the Git Updater

Setting Your Download Files

Once you have connected your website to either GitHub or Bitbucket, you can add files to your Download products.

1. The “Download Files” metabox on the download edit screen will now have a checkbox labeled “Fetch download from a git repository.”

2. After a moment or two, a new set of fields will show up that will allow you to select a repository.

3. Search for the repository name, and then select the tag that you want to use.

Note: The Version Tag used in Git Updater is required to be a native git tag. It does not parse versions from your readme file. To learn more about using the tag feature in git, you can visit this guide.

4. Click “Fetch Now”. When your download has been successfully imported from the git repository, the button will say “Fetched”.

5. You can now edit the file and/or zip name if desired, or leave them as default. Your zip file is ready to go!

When you are ready to release a new version, simply select the tag you wish to use and click fetch. After fetching is complete, update your product.

FAQs & Troubleshooting

How do I exclude or remove files before the zip is generated?

The Git Download Updater uses the ‘export’ feature of Git to build out the file to deliver. You can use the `.gitattributes` file to determine what files you want to ignore during the export. Here is an example of how we use it for EDD Core.

For more details on using git attributes to exclude files, see this tutorial.

Update conflict between free and paid version

There are two different ways to resolve this issue:

1. Change the name and/or slug of the pro version. Because of a nuance with the WordPress update API, WordPress cannot actually distinguish them as separate plugins.
2. Add “wp_override” to the third parameter of the EDD_SL_PLugin_Updater class when it is instantiated, like this:

// set up the updater
$edd_updater = new EDD_SL_Plugin_Updater( EDD_SAMPLE_STORE_URL, __FILE__, array(
		'version'     => '1.0', 				// current version number
		'license'     => $license_key, 		// license key (used get_option above to retrieve from DB)
		'item_id'   => EDD_SAMPLE_ITEM_ID, 	// name of this plugin
		'author'      => 'Easy Digital Downloads',  // author of this plugin,
		'wp_override' => true
	)
);

Note: this requires v1.6.4 of the plugin updater class.

The post Git Download Updater – Setup Documentation first appeared on Easy Digital Downloads.

The post Purchase Limit Setup first appeared on Easy Digital Downloads.

Installing the plugin and Activating your License key:

EDD Custom Prices uses licenses to provide automatic updates for the extension. Once
installed and activated you should first activate your license key in order to receive automatic updates. You will have received a license key in your purchase receipt; copy the key to your clipboard, then go to  Downloads → Settings → Licenses and enter the key into the “License Key” field under “Custom Prices”. Click “Save Changes” to activate your license.

Anytime a new version of the extension is available, you will be notified of the update just like any other WordPress plugin.

Enabling Custom Prices for a product

To enable custom prices for a product, find the product which you want to enable them for under
Dashboard → Downloads → All Downloads. Then, in the “Download Prices” metabox, click to enable custom pricing. You’ll have a few additional options there:

Default: This option allows you to set what the price is set to by default when the customer first loads the page.

Min: This option allows you to set a minimum price. If the customer tries to enter a lower price than the minimum you set here, they will see a message which says “Please enter a custom price higher than the minimum amount”.

Button Text: This option allows you to write a custom message on the purchase button for this product. For example, you can instruct the customer to “Pay whatever you want”, or to “Enter your custom price”. It defaults to “Name your price”.

Bonus Item: This option allows you to give away a single bonus product if the customer enters a high enough (or low enough) custom price. First, enter the “Condition” required to get the custom product. Then, set the price required to receive the bonus product. Lastly, choose which product the customer will receive upon purchase.

Integrations with other extensions

EDD Recurring Payments

If you use the Recurring Payments extension for Easy Digital Downloads and you have both Custom Prices and Recurring Payments enabled for a product, when a customer enters a custom price, their subscription will automatically be set up for that custom amount. Therefore, when their subscription automatically recurs, the amount they will be charged will be the custom price they entered.

If you enable free trial, the initial payment will be free and all subsequent payments will be for the custom amount entered by the customer.

EDD Frontend Submissions

If you use the Frontend Submissions extension for Easy Digital Downloads and you want your Vendors to be able to create product that are custom-pricing enabled, there isn’t a way for Vendors to enable that themselves at this time. Instead, once the Vendor has submitted their product, an admin level user will have to log in and enable custom pricing for the product by following the steps above under “Enabling Custom Prices for a product”.

The post Custom Prices – Overview first appeared on Easy Digital Downloads.

Configuration Instructions for License Free Download

1. Once installed, locate the settings for this extension via WordPress admin → Downloads → Settings → Extensions → License Free Download

2. The settings area allows the store owner to set labels for user facing text.

Product Settings

Edit the product you wish to offer for free for existing license holders and locate the metabox titled “License Holders Free Download“. In this box you can activate the Free Download and select which licensed products will give free access to this product.

NOTE: Both products must be using the license creation option of the Software Licensing extension. The checkbox to activate it for a product is on the admin page for every product in the Licensing meta box.

Create the Interface

In order to make it so that people can download the product for free, you must include this shortcode on that product’s page: [edd_lfd]. Paste the shortcode into the content area when editing the product.

The resulting form will look something like this:

The customer will take the license key from their purchase and paste it into this form. They will be immediately taken to the checkout page where they can “buy” the product for free.

The post License Free Downloads first appeared on Easy Digital Downloads.

Setup

After you have installed and activated the Featured Downloads extension, you can find the option to make a Download “featured” by navigating to Downloads → All Downloads and either creating a new Download or editing an existing Download.

Usage

Once you’ve added all of the Downloads you want, there are two ways that you can display the Featured Downloads on your site.

Shortcode

Add the featured attribute to the existing [downloads] shortcode provided by Easy Digital Downloads. This will display a list of all Featured Downloads.

[downloads featured="yes"]

Template Tag

If you’re comfortable adding custom code to your theme, the following code can be used anywhere in your theme’s files to show the Featured Downloads. Typical usage would be in single.php, page.php, or in conjunction with a conditional statement used in functions.php.

if( function_exists( 'edd_fd_show_featured_downloads') ) { edd_fd_show_featured_downloads(); }

Once in place, the featured downloads will be displayed on the page you’ve added either the shortcode or template tag to.

FAQ and Troubleshooting

How are featured products ordered?

• If you are using the shortcode option, featured products are ordered based on your ordering settings for the shortcode. To learn more about how products are ordered when using the [downloads] shortcode in Easy Digital Downloads, view the full document for the shortcode. 
• If you are using the custom code example above, they will be ordered based on the date the product was published. 

The post Featured Downloads first appeared on Easy Digital Downloads.

A new window / tab will open on a Dropbox page that will prompt you to log in and authorize Easy Digital Downloads – File Store to access the files and folders in your Dropbox account.

Click
Allow and you will be provided with a code. Copy the code to your clipboard.

Back on your WordPress site, copy the code into the text box that now appears to the right of the
Register Code button, then click the Register Code button.

If you would ever like to deauthorize the EDD Dropbox File Store plugin or need to reauthorize, you can do so from the same page by clicking the Remove Authorize button that will appear once you have completed the authorization process.

Using Files in Your Dropbox Folder

Once you have completed the setup steps above, setting up EDD to use a file in Dropbox is fairly straightforward. Go to the editor page of the Download you want to change and click the Upload a File link. You will now see two new options on the Upload Media pop-up:
Upload to Dropbox and Dropbox Library.

Dropbox Library

The Dropbox Library allows you to use a file that you already saved to your Dropbox folder outside of WordPress. Clicking on the Dropbox Library option on the left of the pop-up will display the contents of your Dropbox folder starting at the root folder level.

Navigate through your folders to find the file you want to use and click the Select button to the left of the file name.

Upload to Dropbox

The second option available in the Dropbox File Store extension is to upload a file from WordPress to your Dropbox account and then use that file. This option bypasses the need to put your files in your Dropbox folder outside of WordPress.

To upload a file through WordPress, click on the Upload to Dropbox option on the Upload Media pop-up in WordPress. This will display the folder structure of your Dropbox folder along with a button to select the file you want to upload.

Navigate to the folder you want the file saved to and click the Choose File button to select the file on your computer. Once you have selected the file, click Upload and wait while your file is uploaded to your Dropbox folder. When it is finished uploading, the pop-up will display a success message and a new Use File button.

Click
Use File to select the file you just uploaded as the file to use on your download.

Please note: If there is already a file located in the folder you selected with the same name as the file you are uploading, the new file will have a number appended to it to make the filename unique. This will take the form of filename(1).ext. If you don’t wish to share the file with this name, you will need to first remove the duplicate or upload it to a different folder.

Using Your File

With either option, once the Upload Media pop-up closes, the details for your file will be saved as a file on your download. Click Update when you are done with your changes and your users will now download this file from your Dropbox folder.

Downloading Dropbox Files

The link provided to users to download their file from will expire after a period of time defined by Dropbox, currently four (4) hours. This is to prevent users from being able to share the download link with others with the intent to download the file without purchasing the download from your site first.

Troubleshooting

64-Bit Requirements

The Dropbox API requires a 64-bit version of PHP running on a 64-bit server. While this requirement has been relaxed in Dropbox File Store so that you may still use the extension on a 32-bit machine, please be aware that you will receive errors if you attempt to use larger files (over 2 GB in size) if your site is not running on a 64-bit install. In addition, because of a Windows limitation, if your site is running on a Windows server, you will not be able to support file sizes over 2GB even with a 64-bit install.

Maximum Upload Size

WordPress and your website will have a maximum upload size, typically between 2MB and 8MB. If your files are larger than this, you will either need to change your site’s setting that controls this (typically in the php.ini file) or use the Dropbox Library option to configure your download.

Image Upload Errors

There are sometimes issues with uploading images to WordPress, in part due to file size constraints. Please see
Troubleshooting Images on the WordPress Support site for further details. Saving files to your Dropbox folder outside of WordPress and using the Dropbox Library option is a workaround for issues related to image uploads.

Registration Code Expiration

The code provided by Dropbox during the authorization process expires after a short period of time and is only good for one authorization. If you receive an error when registering the code, you may want to try again with a new code before any further troubleshooting steps.

Blank Screen When Getting Code

This indicates a problem with cURL on your own server. Often cURL not installed or configured. You can test this by installing the
Error Log Monitor plugin and looking at the log in your Dashboard after trying. Inform your system administrator or hosting provider of the problem and include the error logs you’ve saved.

The post Dropbox File Store Setup Documentation first appeared on Easy Digital Downloads.

Setup

Once installed, you’ll see a new “Download Images” area when creating/editing a Download. 

You can add multiple images using the Media Uploader just as you would with standard Wordpress image uploads. 

Shortcode Usage

You can use the following shortcode to display the additional images in the content area for your Download. 

[edd_download_images]

Custom Usage

Second, you can output an array of the images to be used for more customized setups (custom page templates, slideshows, etc). 

Example:

If you are In the loop, you can use the following function to retrieve an array of images:
edd_di_get_images() 

This function uses the get_the_ID() function so it will only work when the WordPress loop has a post loaded.

To retrieve the images for a specific Download ID you can use the following: 

get_post_meta( $post_id, 'edd_download_images', true );


Need help with customizing additional images? We recommend hiring a developer through Codeable make the custom changes you need.

The post EDD Download Images first appeared on Easy Digital Downloads.

The Recently Viewed Items extension allows you to show your visitors the items they’ve viewed while browsing your site, offering you an opportunity to increase your sales by showing them the items they’ve already shown interest in. Getting started is easy.

Once installed and activated, the extension will display recently viewed items on single download pages and on the checkout page by default. There’s also a widget for displaying recently viewed items in your sidebar or other widget areas that your theme supports.

Single Download Pages

By default, recently viewed items are displayed on single download pages. This can be changed using the extension’s settings. These settings can be found by navigating to Downloads → Settings → Extensions.

There are two settings related to single download pages:

Disable Display on Single Download Pages – This turns off the automatic display of recently viewed items on single product pages. This is useful if you want to do things manually, use the widget instead, or just show them only on the checkout page.

Single Download Heading Text – Allows you to supply a custom heading above the recently viewed items.

Checkout Page

By default, recently viewed items are displayed on the checkout page and include an Add to Cart/Purchase button so that customers can easily add an item to the cart without leaving the checkout page. This display can be disabled in the extension’s settings.

There are two settings related to the checkout page:

Disable Display on Checkout – This turns off the automatic display of recently viewed items on the checkout page. This is useful if you want to minimize distractions on your checkout page, or if you’d prefer to implement an alternative display manually.

Checkout Heading Text – Allows you to supply a custom heading above the recently viewed items.

CSS / Styles

The extension includes some basic styles for making sure the recently viewed items are displayed with adequate spacing, etc, but this may not look exactly the way you want on all themes. In these cases, you can disable the built-in styles and let your theme style them or provide your own custom styles. Check the Default Styles box to disable the extension’s styles.

Widget

The extension includes a widget for displaying recently viewed items in any widget area your theme supports. Simply add it to the desired widget area and adjust the settings to your liking.

Customization and Developer Information

The extension defaults to showing 3 recently viewed items on single download pages and on the checkout page which is intended to keep things clean and less distracting. If you want to change that number, or otherwise make customizations to the layout, you can override the templates used by the extension.

Customizing Templates – To customize the templates, make a folder in your active theme called edd_templates. Copy the appropriate template from the templates folder of the extension into your edd_templates folder and make your customizations there.

You can read more here on moving template files: https://docs.easydigitaldownloads.com/article/1216-moving-edd-templates-to-your-theme

There are two templates included:
edd-rvi-single.php – This is used for displaying recently viewed items on single download pages.

edd-rvi-checkout.php – This is used for displaying recently viewed items on the checkout page.

Customizing Image Sizes

There are two ways to customize the size of the images shown.

1. Customize the template using the Customizing Templates section above.

2. Filter the size using the filters available inside the templates. Available image size filters are:

edd_rvi_single_image_size
edd_rvi_checkout_image_size
edd_rvi_widget_image_size

Example code for filtering the checkout image size:

function custom_rvi_checkout_image_size() {
return array( 600, 450 );
}
add_filter( 'edd_rvi_checkout_image_size', 'custom_rvi_checkout_image_size' );

The post Recently Viewed Items Documentation first appeared on Easy Digital Downloads.

Restricting Content

Once activated, Content Restriction provides two ways to restrict access to content:

1. By restricting the whole page or post using the “Content Restriction” settings within the post or page.
2. Using the [edd_restrict] shortcode.

Content Restriction uses an OR condition for the products, so if you select Product X and Product Y, the content will be accessible to customers that have purchased Product X or whom have purchased Product Y.

You can also restrict content to verified customers of any product in your store by selecting the Any option. Note: This is specific to the shortcode restriction option.

Integrating with Recurring Payments:
You can restrict access to content if the Download is tied to a Subscription. See Recurring Payments – Content Restriction Integration for details.

Integrating with Software Licensing:
If the Download contains a license key, you can further restrict access to only active license keys. When enabled, this doesn’t affect access to selected downloads that don’t have Software Licensing enabled.

Restricting the full page / post

Restrict the full page or post using the Content Restriction settings below the content editor.

1. Select “Restrict this page” to view options.
2. In the Download dropdown, select a specific download or “Customers who have purchased any Download”.
3. If the Download contains variations, you can select a specific variation or “All prices” in the “Download Variation” column.
4. Additional Downloads can be added using the “Add New Download” button.

Shortcode

Also included in the plugin is a short code that will allow you to restrict portions of content. For example, to restrict a paragraph to only buyers of a specific download, you can do this:

[edd_restrict id="#"]This content is restricted.[/edd_restrict]

The # is replaced with the ID number of the Download product.

The short code accepts three parameters:

• id – This is a comma separated list of download ID numbers. Note that you can also put the word “any” to allow any purchase.
• price_id – This is the ID number of the price you want to restrict content to
• message – This is the text shown to non-buyers

If you want to restrict content to buyers of multiple downloads, you can use the shortcode like this, which will result in the content being restricted to download ID 23 or 254:

[edd_restrict id="23,254"]This content is restricted.[/edd_restrict]

If you would like to restrict a download to a particular price ID, then use:

[edd_restrict id="23" price_id="2"]This content is restricted.[/edd_restrict]

If you would like to restrict a download to any product purchased, do the following:

[edd_restrict id="any"]This content is restricted.[/edd_restrict]

There is also a shortcode you can use to show content to someone who has not purchased a specific product. You can use it the same way as the shortcode above. The shortcode is “edd_cr_no_access” and can be used like this:

[edd_cr_no_access id="#"]Preview of locked content here[/edd_cr_no_access]

Displaying Accessible Restricted Pages After Purchase

When you have posts, pages, or custom post types restricted to products, a list of these pages will be automatically displayed on the purchase confirmation page in order to make it nice and simple for your customers to find the content they have just purchased access to.

You can also add the {page_list} template tag to the email purchase receipt in order to show the list in the emailed receipt.

You can also place the [edd_restricted_pages] short code on any page in order to display a list of the posts and pages the logged in customer has access to.

Settings

The global Content Restriction settings are located under Downloads → Settings → Extensions → Content Restriction.

Hiding Menu Items: Content Restriction allows you to hide navigation menu items from customers that have not purchased the necessary products in order to view the content. With this item checked, any navigation menu item that the customer does not have access to will be automatically removed from your site’s menus when that customer is logged in.

Include Bundled Products: In enabled, products included within a bundle will be considered purchased when determining Content Restriction access rights.

Single, Multiple & Any Product Messages: Use these fields to edit the messaging that appears to visitors that don’t have access to restricted content.

Frequently Asked Questions

How does the {page_list} email template tag order the unlocked pages?

The pages shown when using {page_list} are ordered based on the order that the items were added to the cart by the customer. If there are multiple pages that get unlocked because of a specific product being purchased, the order in which you’ve set up those restrictions is the order in which they are shown from there.

Here’s an example to help illustrate the order:

– You create “Page 1” and set it to be restricted to “Product A” on Jan 1, 2017.
– You create “Page 2” and set it to be restricted to “Product A” on Jan 2, 2017.
– You create “Page 3” and set it to be restricted to “Product B” on Jan 3, 2017.

If the customer puts “Product b” into their cart first, and then adds “Product a” after that, and then completes purchase, the order that {page_list} will show pages in will be:

– Page 3
– Page 1
– Page 2

The post Content Restriction Documentation first appeared on Easy Digital Downloads.

In This Article

Creating an IAM account
IAM access keys
Setup
Using Amazon S3 With EDD
Forcing Files to Download
Common Issues and Questions

Creating an IAM account

In order for Easy Digital Downloads to connect to your Amazon S3 account, you will need to create an IAM user and attach a permissions policy to the user. You can click Show User Security Credentials to view the access key and secret key. These are the values you need to enter in your WordPress site at Downloads → Settings → Extensions → Amazon S3.

1. Log into your Amazon S3 account

Log into your Amazon S3 account and navigate to the Users page. This page can be found by clicking on your account name in the top right corner and clicking on Security Credentials > Users (Under Access management on the left side of the page).

2. Setup IAM User

A. Add User

If you have an existing IAM user you wish to use, click on that user. If you need to create a new user, click the blue Create User button and follow the prompts. You now need to obtain security credentials and also attach a permissions policy to the user.

B. Set user details:

User name: Create User name of your choice and click Next.

C. Set permissions

1. Select “Attach policies directly” box.
2. Then, in the Filter box, enter “S3full”. That will filter the results down to those that are relevant for Amazon S3.
3. Check the box for AmazonS3FullAccess.
4. Ignore “Set permissions boundary – optional” section.
5. Click Next.

D. Review and create

Confirm your permissions match the instructions above. Otherwise, there is nothing to configure here, click Create user.

3. Get Access Keys

You will need an IAM account using the permissions in the above steps. If you’ve created an IAM account in the past with the AmazonS3FullAccess permissions, you can use the existing account.

A. Click IAM user name created above, listed in your AWS Users page.

B. Click on the Security Credentials tab and click Create Access Key.

C. Select Third-party service and Check Confirm.

D. Click Create access key. Not description tag is required.

E. Save Access key & Secret access key.

Note: You will not be able to access the secret key ever again for this user, so make sure that you save the file. If you lose the credentials, you will need to create a new access key.

Your IAM user should now have full permission to access and upload files to the S3 bucket. This provides your EDD store with access to your files and the ability to create secure download links for customers.

F. Add Access key & Secret access key to your EDD store’s Amazon S3 settings under Downloads → Settings → Extensions → Amazon S3.

If you need more assistance creating IAM users or attaching policies, see Amazon’s guide on creating IAM users for more information.

Limit Access to Specific Buckets

If your S3 account is used for other purposes and you want to limit your IAM account (EDD Store) to specific buckets, you can create a custom policy in place of AmazonS3FullAccess. This is done in place of Step 3 of the Set Permissions section.

Click “Attach existing policies directly”, then select “Create Policy”:

Add the policy details below via the JSON editor. Update bucket-name-here with the name(s) of the buckets you want accessible via your EDD store.

{
    "Version": "2012-10-17",
    "Statement": [
        {
            "Sid": "VisualEditor0",
            "Effect": "Allow",
            "Action": [
                "s3:PutObject",
                "s3:GetObjectAcl",
                "s3:GetObject",
                "s3:ListBucketMultipartUploads",
                "s3:AbortMultipartUpload",
                "s3:ListBucket",
                "s3:ListMultipartUploadParts"
            ],
            "Resource": [
                "arn:aws:s3:::bucket-name-here",
                "arn:aws:s3:::bucket-name-here/*"
            ]
        },
        {
            "Sid": "VisualEditor1",
            "Effect": "Allow",
            "Action": "s3:ListAllMyBuckets",
            "Resource": "*"
        }
    ]
}

When using this policy, all Bucket names will be viewable but only the ones you place in the Resources section are accessible. If a bucket that is not included in the Resource list is accessed via EDD, a PHP error will occur. We hope to improve this in a future release.

Setup

Once the extension is installed and activated you can navigate to Downloads → Settings → Extensions → Amazon S3 and enter your Amazon S3 account info.

1. Enter the Access Key ID and Secret Key

The Access Key ID and Secret Key are obtained by creating an IAM user in your S3 account. See
our guide above for information on how to create an IAM user with the proper permissions.

2. Enter a default Bucket

This is the default bucket that you want files to be uploaded to. In order to create new buckets or get a listing of your current buckets, go to your S3 Console (you must be logged in to access the console). Enter the name of the bucket you would like to use as the default here. When uploading files to Amazon S3, you will have the option to select the bucket you wish the file to be uploaded to.

Bucket Permissions

Your bucket should have Block all public access ON, in order to restrict unauthorized access to files. EDD will provide temporary access to files to customers.

3. Enter an Amazon S3 Host (Optional)

This is the S3 host that your bucket is using. Most of the time this field can be left blank. However, if your site has issues accessing your bucket, try changing this to the Endpoint for your bucket’s region, for you default bucket.

You can find your bucket’s region by logging into your AmazonS3 account, clicking on S3, and then taking a look at the region column listed beside each bucket. It will say what the region is. Once you know that, find the right corresponding host listed on the Amazon S3 Region Documentation. Copy and paste that host and hit save in your WordPress.

4. Link Expiry Time (Optional)

This is the number of minutes that the dynamically generated URL is valid for. When a customer clicks on a download link delivered by Easy Digital Downloads, a new URL for the file on Amazon S3 is generated on the fly. This is the number of minutes the new, secret URL is valid for.

This completes setup of Amazon S3.

Using Amazon S3 With EDD

You will upload files to a downloadable product in exactly the same way as before but you will have two new tabs in the media uploader called Upload to Amazon S3 and Amazon S3 Library.

When you upload a file from this tab, it will be automatically uploaded to your Amazon S3 account. Any file that you upload to S3 will be accessible from your WordPress Media Library, just like any other media file.

Uploading to Amazon S3 via EDD

When you upload a file from this tab, it will be automatically uploaded to your Amazon S3 account.

Adding files already on Amazon S3 to EDD

Any file that you upload to S3 will be accessible from your WordPress Media Library, just like any other media file, via Amazon S3 Library in the media uploader.

Alternatively, you can add files to the File URL manually:

Forcing Files to Download

Sometimes your web browser will try to display or play whatever file you’re downloading, and you might end up playing music or video inside your browser, instead of saving it. There are a variety of things that can be done to prevent this, and force the save option, but if you’re storing your files on Amazon S3 then any settings on your web server are ignored.

Instead of relying on the settings of your web server you must configure options properly in S3. Here’s how they should be set.

Note: This setting is applied to a file and/or folder but not the whole bucket

Opening Properties

1. In your S3 Bucket find the file you wish to work with and select it.
2. Click Actions >  Change metadata. 
   
3. Click Add Metadata and set the Type to System Defined, Key to Content-Disposition and set the Value to attachment and Save changes.
   

This will force it to be downloaded instead of played or displayed in your browser.

Common Issues and Questions:

Files open in browser instead of downloading

This can be resolved by Forcing Files to Download.

Will customers be able to see the actual URL of the file and simply download it directly?

No, the customer will see a URL going to your own store, where EDD will translate the location so the download works without the customer seeing the original Amazon source URL.

Error: SSL certificate problem: unable to get local issuer certificate

This error means that the SSL certificate on your website’s server is invalid or installed improperly. To resolve this, contact your hosting company and request that they verify the certificate is installed properly and valid.

Error: Access Denied

This error means that the user of access key ID and secret key you are using does not have the necessary permissions to access S3 buckets and resources.

To resolve this, you will need to attach a new permissions policy to the IAM user. See our
guide on creating an IAM user with the proper permissions to resolve this error.

You may also see this error message if you copied the URL from Amazon S3 and pasted it into the File URL field of your Download. Please see the note above regarding the proper steps that need to be taken to link your files to your Downloads.

Error: RequestTimeTooSkewed

This error happens due to a misconfiguration of your web server’s timezone settings. To resolve it, contact your hosting company and ask them to reconfigure the timezone settings properly.

Error: SignatureDoesNotMatch

If you receive this error, followed by an error message that says
The request signature we calculated does not match the signature you provided, it likely means that your bucket name contains capital letters or spaces. To resolve the issue, rename your bucket so that it does not contain any capital letters. You may also create a new bucket without any capital letters in the name to resolve it.

Error: NoSuchKey The specified key does not exist

This error occurs when there’s an issue with the way the file, or even the bucket, is named. All punctuation and special characters should be removed.

For example: If you have a file named test-file-one.mp4.zip change it to testfileone.zip

Other errors or problems uploading files to Amazon S3

If you have issues uploading files to Amazon S3 or accessing existing files in Amazon S3, consult the steps below to resolve the issue.

1. Check your Amazon S3 Host settings in Downloads → Settings → Extensions → Amazon S3. Ensure that your host is set up correctly, including checking you have set up the correct region (read the point on Amazon S3 Host above to see how to do this).
2. Ensure the filename of your file is within the maximum limit of 1024 characters. You can find more information in Amazon’s documentation on how to correctly format your filenames.
3. If you have recently switched to a new Amazon S3 account, and are having trouble uploading files to your bucket(s), this is typically a temporary issue that can happen soon after creating new buckets or accounts. It should resolve itself automatically after a few hours. See Amazon’s documentation for more information on this.
4. Still no luck? Contact support and include the exact error message or behavior you’re experiencing.

Software License updates failing due to Download failed. cURL error 8: Invalid Content-Length: value

It’s possible the Amazon S3 extension is not forcing redirect for downloads. If you see this error try
setting the Download Method to Forced.

Customer sees Update Failed: Download failed. Internal Server Error when attempting to update a plugin

Confirm that the source file to be used for automatic updates is selected in the Download’s licensing settings.

You will likely see the following PHP Fatal error in the store’s PHP error log file:

PHP Fatal error:  Uncaught InvalidArgumentException: Found 2 errors while validating the input provided for the GetObject operation:
[Key] is missing and is a required parameter
[Key] expected string length to be >= 1, but found string length of 0 in /home/ph198/public_html/wp-content/plugins/edd-amazon-s3/vendor/aws/aws-sdk-php/src/Api/Validator.php:65

The post Amazon S3 first appeared on Easy Digital Downloads.