In this article, we’re show you where to find common features from the Gumroad platform within Easy Digital Downloads so that you can easily start selling your products yourself.

Gumroad Product Types

Easy Digital Downloads is perfect for selling all forms of digital products and services. Many of the custom product types offered on Gumroad can be created as a ‘Download’ by going to the Downloads section and clicking ‘Add New’.

Some of the product types that are available in Gumroad require features only available with the Pro version of Easy Digital Downloads.

Membership

The membership product type is equivalent to a Subscription in Easy Digital Downloads and requires the Recurring Payments feature. Additionally with the Content Restriction feature can be used to restrict your site content based on a user’s purchase history.

Both Recurring Payments and Content Restriction are available in the Extended Pass.

Physical Good

While Easy Digital Downloads is designed to sell digital products, we do recognize that you may want to offer a limited number of physical products. For that we have our Simple Shipping feature, which allows you to offer flat rate domestic and international shipping for these products.

Simple Shipping is available in the Professional Pass.

Creating your product

Nearly all of the features in Gumroad have a one-to-one matching feature in Easy Digital Downloads when creating your product. Below is a visual guide of where to insert specific Gumroad product settings into your Easy Digital Download product.

Discount codes

Easy Digital Downloads offers stand-alone discount code management. Discount codes are not tied to a single product and have advanced features to allow you to offer your customers discounts on all products, specific products, and even exclude products. They can also be set with features like:

• Starting and Expiration dates.
• Percentage or Flat Rate
• Included and Excluded products
• Single user per customer
• Max uses
• Maximum discount amount
• Custom name (to make it easier to manage your discounts)

To create your discounts in Easy Digital Downloads, you can head to Downloads > Discounts > Add New. You can also read our full documentation on discount codes.

Accepting Payments

Easy Digital Downloads has partnered with Stripe and PayPal to offer you multiple ways to accept payments including Credit Cards, PayPal, Apple Pay, Google Pay, PayPal Credit, and many other available options. Once installed head to Downloads > Settings > Payments, and you can take payments with Stripe and PayPal with our one-click connection.

Additional Features

While we’ve covered the basic settings needed to create your products in Easy Digital Downloads, there are additional features that Easy Digital Downloads also offers. Below we’ve outlined these features, with the Easy Digital Downloads equivalent.

Easy Digital Downloads is a fully self-hosted eCommerce Platform that you can add to your WordPress powered site. Self-hosted means that all your data is yours, and is stored on your server. Either way, if you already have a WordPress site or are ready to get started with a new WordPress site, head over to our getting started page, and you can start selling today.

The post Migrating to Easy Digital Downloads from Gumroad first appeared on Easy Digital Downloads.

First, what is SSL?

SSL is an encryption system that encrypts all the information between your customer and your web server. This makes it much safer for people to send sensitive information (like credit card info) to your server.

How do I know if I have it or not?

When SSL is working properly you’ll see a lock in your browser’s address bar:

Why do I need it?

1. As mentioned above, it encrypts all the information between your end user and your server. Having someone get their identity stolen while using your site isn’t worth the headache.
2. It’s required by some payment processors. See this article on WP Beginner.
3. People won’t trust your site without it. People have been well trained to look for the lock in their browser, and won’t buy without it, even if you manage to find a way to not need it technologically.

What if I use PayPal, and people don’t pay on my site?

With the exception of PayPal Express, you do still need SSL. Full documentation regarding PayPal and SSL here.

Do I need SSL even while testing?

Yes.

The post Do I need an SSL Certificate? first appeared on Easy Digital Downloads.

Under Downloads > Orders, on the list of orders, you may hover over a specific entry and get a link to resend the receipt.

Additionally, if you View Order Details, on the Edit page for a single order inside the
Order Details > Email section, you’ll find a button labeled Resend Receipt.

Additional Options

How do I filter products by category, tag, price, or other fields?

Easy Digital Downloads does not by default include filtering options for categories, tags, prices, or other product fields. There is, however, a great plugin called FacetWP that allows you to easily add this kind of filters to the [downloads] shortcode. See FacetWP’s video walkthrough for an example of how this can be done.

How can I resend the purchase receipt?

Oftentimes the receipt is the only place your customer keeps a link to the product they’ve downloaded. If they lose that receipt, or if it never gets through on the initial send, you’ll probably hear from them asking for a new copy. This document explains how to easily resend that to them.

Under Downloads > Orders, on the list of orders, you may hover over a specific entry and get a link to resend the receipt.

Additionally, if you View Order Details, on the Edit page for a single order inside the Order Details > Email section, you’ll find a button labeled Resend Receipt.

Additional Options

If your goal is to get the proper download link to a customer then you may want to create a page with the [purchase_history] shortcode on it. If your customer has an account on your site they will be able to log in and see all their purchased items and download them whenever they like, assuming your EDD settings allow them access.

How can I change the number of products shown on an archive page?

There are two different ways to accomplish this.

Change It Everywhere

If you’d like to make a global setting that affects ALL archive pages then you can use the “show at most” setting under WordPress’ Settings > Reading page.

This affects all archives on your entire site, including EDD Product archives, Blog archives, and any custom post archive you may have.

Change It In One Place

EDD provides a shortcode called [downloads] which renders a product archive and accepts a number for how many you’d like to show. Here’s a simple example:

[downloads number="15" columns="3"]

In-depth documentation on [downloads] is available here.

Can I add a custom field value to the Add Cart button?

At this time it’s not possible to add a custom field to the Add Cart button, neither on the single page nor the archive page.

Can Customers View Past Purchases?

Yes, you can create a customer account page by using the [purchase_history] shortcode that will display a list of a customer’s purchases when they are logged into their account. See our doc on how to setup the customer account page for more information.

Product Pages Show 404 Error.

To get rid of the 404 error when viewing a download, you need to re save your permalink structure. Go to Settings → Permalinks and click “Save Changes”. If re saving the permalink structure does not resolve the 404 errors, try deactivating all other plugins and switching to one of the default WordPress themes to determine if there is a conflict.

Are download files protected?

Yes, all files attached to Download products are protected from theft. When a file is uploaded to a Download product, it is automatically placed in a special folder on your server that is protected via a . htaccess file. This prevents a web browser from simply visiting the folder that holds your files and viewing them all.

How does the download work?

Easy Digital Downloads knows where the file is, and has permission to access it. The download link the customer receives goes to a special URL that does things like determine if the file is allowed to be accessed at all, fetch the file and send it to the browser, etc.

What about if it’s hosted someplace like Dropbox, or Amazon?

Easy Digital Downloads knows how to keep these files safe as well, using the same method as above. Setup information for Dropbox and Amazon.

What if my server isn’t using Apache?

Files are only protected by default on servers that use Apache. If your server is running something else you will need to take a look at protecting them through another means. Here are some articles to help with different server configurations known to need custom tweaking:

• Protecting files on NGINX
• Protecting files on WPEngine
• Protecting files on Pantheon
• Protecting files on Kinsta

What about images and audio files?

Image files and Audio files (MP3/OGG) are 2 exceptions to the “protected” rule. They are left unprotected so that your visitors can actually see the images you upload – like your download’s featured image, or hear the preview audio you upload for an audio product. Because of this, it’s important to note that if you happen to be selling images or audio files, image files and audio files will not be protected even though they are in the protected directory. To fix this, we recommend that your actual deliverable files are compressed into a .zip file before uploading to your website. To read more about that, click here.

What is causing Your purchase session could not be retrieved error?

This can occur for a number of reasons but confirm that your Order Confirmation page is set and has the correct Block or shortcode. If you are using PayPal Standard, switch to PayPal. Otherwise, something else is interfering, such as another plugin, theme or caching. You can test this by disabling all plugins except EDD and see if the error still appears when making a test purchase.

Your checkout page is using the legacy shortcode.

We have blocks for many of our shortcodes, which have improved features. If possible, we recommend switching to the equivalent block but it’s not required and the shortcode still works if you can’t switch.

Error 101: Error 102: You don’t have permission to download this file

This is likely due to another plugin interfering with EDD. Please try deactivating all plugins except Easy Digital Downloads and the required extensions. Note, this could be caused by 3rd EDD extensions as well, make sure to disable those as well.

After downloading a purchased file, the file is corrupted or the zip file is empty

First, download the source file, as an admin and confirm the file is not corrupted and works as expected. If the file is corrupted or empty after downloading via EDD, it’s likely something external to EDD is interfering with the download process, likely another plugin or caching.

The post FAQs first appeared on Easy Digital Downloads.

In your fastcgi-php.conf file, ensure you have allow-x-send-file enabled, like so:

"allow-x-send-file" => "enable"

If you do not enable allow-x-send-file, you may get corrupted file downloads, as detailed in this support ticket.

The post Configuration for Lighttpd fastcgi-php.conf first appeared on Easy Digital Downloads.

To fix this, find the transaction under Downloads → Payment History and click
View Order Details.

Then look for the Customer Details section. If there is no customer associated then you can choose your customer from the drop-down list.

Once your customer is associated with the transaction properly then their license will appear again in their purchase history.

The post Customers Can’t Access License Information first appeared on Easy Digital Downloads.

The exception to this policy involves local installs using something like MAMP, WAMP, Vagrant or Desktop Server. These are obviously not being used as live servers so you may activate your license there without using one of your allowed activation numbers.

Here’s How It Works

License activations are tied to URLs.  In order to make it so you may activate licenses on local development servers (servers that run on your laptop or desktop) we’ve allowed some common URLs and IP addresses to not count against your license activation count.

• localhost
• 10.0.0.0/8
• 172.16.0.0/12
• 192.168.0.0/16
• *.dev
• *.local
• *.test

You may activate your licenses on any of the above URLs or IP addresses and it won’t count against your activation limit.

If that doesn’t work, you can set your site to staging using this wp-config entry:

define( 'WP_ENVIRONMENT_TYPE', 'staging' );

If you are unsure of how to edit your wp-config.php file, please consult the official WordPress help page on editing the file.

Note: you must place this code above the line that says:

/* That's all, stop editing! Happy blogging. */

The post How can I ignore Local Host URLs for Activation? first appeared on Easy Digital Downloads.

The post Spider Cache first appeared on Easy Digital Downloads.

The post Will Easy Digital Downloads work on WordPress.com? first appeared on Easy Digital Downloads.

The post Does Easy Digital Downloads Work With LearnDash? first appeared on Easy Digital Downloads.

One of the tools we use to better understand the needs of our users is usage tracking. If you are using the Free version of Easy Digital Downloads, you can help us by navigating to Downloads -> Settings -> Misc in your WordPress dashboard, you can opt into usage tracking by selecting the Yes, I want to help! setting found under the Join the EDD Community section.

Below, you will find a description of what information will be included once you have saved this setting.

Is my data Private?

Yes! Our mission is not to know data about any one specific site, but to have a better understanding of how you use Easy Digital Downloads, as a community. This allows us to make data-driven decisions about what features to build, remove, or spend time improving to ensure that we provide the most value we possibly can.

In the most recent changes to our Usage Tracking, we’ve completely stripped out any data that we could identify as personally identifiable. This includes any text fields, text areas, URLs, etc. We don’t even include the URL of the site in the data. Upon the first check-in, we generate a unique hashed string that is salted with data from your site that we do not know. We’ve also modified the headers that are sent with the WordPress HTTP API so that your URL is not included in the User Agent string that is sent by default.

Furthermore, we’ve configured the server that the data is sent to in a way that it does not store access logs, so that the IP Address of your site is not connected to your site’s unique ID.

WordPress

• Active Theme/Plugins: With there being so many Plugins and Themes out there, this information lets us make sure more heavily used themes and plugins are given extra attention during testing and work seamlessly with each update to Easy Digital Downloads.
• Locale: We want Easy Digital Downloads to be accessible to everyone, and knowing the site’s locale helps us focus our translation efforts.
• Timezone: We have users across the globe, so knowing the densities within various time zones helps us provide the best support coverage possible.
• SSL Enabled: An SSL Certificate is essential to an ecommerce site, knowing how many sites haven’t made the jump assists with our testing.
• Multisite: If a site is a multisite network, knowing the sub-site count helps us ensure Easy Digital Downloads scales properly for large networks.
• Version: Knowing what WordPress Versions are being used with Easy Digital Downloads helps us better understand what features in WordPress we can take advantage of as new features are released.

Easy Digital Downloads

• Key Dates: Knowing when a user first started using Easy Digital Downloads assists with knowing how easy Easy Digital Downloads is to get up and running.
• Aggregated Store Stats: Sites of all sizes, ranging from small to very large, enjoy Easy Digital Downloads. Stats related to orders, the gateways that are used, how frequently they process refunds and similar data help us make sure our features and updates get tested in situations that closely match our customers’ site environments and Easy Digital Downloads usage. That way we can be sure those additions will work great for everyone. Don’t worry though, again, we intentionally built this in a way that does not send identifying information.
• EDD Settings: As we strive to add features, this allows us to determine which new settings or areas are getting used most frequently (as well as which settings are not used much). Please note that all sensitive settings such as API keys, email address, or other text fields that may included personal information are automatically excluded from tracking, and are not sent to the server.
• Active Integrations: With our growing library of integrations, knowing the popularity of each one helps us determine where resources should be allocated.

Web Server

• PHP and MySQL Versions: These details help us make sure our testing procedures have proper coverage to avoid compatibility issues.
• Server Software: This reports if the web server software is Apache, Nginx, or similar, which is used for testing purposes.

When do we collect data?

When you initially opt-in to help us out, we’ll send the first set of data as soon as possible. We will then schedule a background task to send this once a week. We’ll also send it as soon as EDD runs an upgrade as well.

The post What information will be tracked by opting into usage tracking? first appeared on Easy Digital Downloads.

1. The customer may have used a different email address to purchase

Check the customer’s purchase and the email associated with their user account. If the customer did use their registered email to purchase, ensure the email address is correct. You can find the email address the customer used in Downloads → Orders against their purchase, or in the Downloads → Customers screen.

2. The customer may have used a different user account to purchase

Check the customer’s user account against the purchase they made in Downloads → Orders by clicking the order in question. Click View Customer Details to see more information on the customer’s user account.

3. Check that the customer’s purchase record is connected to their user account

To do this, locate their purchase record in Downloads → Customers. You’ll then be able to see if there is a User ID assigned to the customer. If there is no user ID, you can connect one by clicking Edit Customer. Begin typing the customer’s username in the field that says “Enter username” and select the customer’s username. Click Update Customer to save the username against that customer.

To learn how to create a page that allows customers to view their purchase history, check out our doc on how to set up a Customer Account Page.

The post Why can’t a customer see their purchase history in their account? first appeared on Easy Digital Downloads.

/downloads
/downloads/
/checkout
/checkout/
/purchase-confirmation
/purchase-confirmation/

Variation: If you change the default pages for options 2, 3, and 4 in Downloads -> Settings -> General, then edit the URIs above to reflect that.

The post Hyper Cache Configuration first appeared on Easy Digital Downloads.

As of iOS 13, iOS devices have the ability to download certain files. Rather than viewing or streaming from the browser, a user sees a prompt to Download the file. This downloads to the device’s iCloud Drive.

Files Don’t Open in iOS:
If a commonly used file time doesn’t open in the browser, you can try changing the Download Method to Redirect with Symbolically Link Files enabled.

For other types of files it will try to open the proper application to view those files. If it can’t find one it will ask what application should be used. See the screenshot below:

If you or your customer need the file on your iOS device we recommend it be downloaded on a computer first, and then use iTunes to transfer the file to the device. Instruct your customers to open the email receipt from their main computer, and transfer the file to their device.

Amazon S3:
Another option is to use Amazon S3. In most cases if your file is hosted on S3, if iOS supports the file type, it will be accessible via the browser. For example, a mp3 can be played via the browser rather than downloading it.

The post Download Issues with iOS (iPad, iPod, iPhone) first appeared on Easy Digital Downloads.

License expired

In this case an update will appear as available, but you won’t be able to get the update.
Check out our docs on how to renew your existing license.

License not activated

If you never entered your license key into your EDD Settings then your license isn’t activated and updates won’t work. To activate your license key go to Downloads → Settings → Licenses you’ll see the fields for entering your keys.

License activated on the wrong site

It’s common for people to activate their key on a development site, and then publish the entire site to the live server, which has a different domain name, so the activation is invalid.

Note: you generally don’t need to activate a license on a development server. Extensions do not require an activated license key to function, it simply won’t get auto updates.

To change the URL on which your license is activated, visit your Account page at
https://easydigitaldownloads.com/your-account/. Documentation on how to change your activation url is here.

Then simply activate it on the proper site, following the directions above.

The post Updates don’t show up for my extensions first appeared on Easy Digital Downloads.

This is typically a side effect of using a plugin on the site that blocks access to the /wp-admin/ area of WordPress. To resolve the NULL error, start by deactivating all other plugins on your site and then test applying a discount code. If that resolves it, reactivate the plugins one at a time until the problem comes back. Once it has returned, you will know which plugin is causing it.

If you need to remove access to the /wp-admin/ area, we recommend using the Remove Dashboard Access plugin.

The post Discount codes: NULL error message when applying discount first appeared on Easy Digital Downloads.

The post Do you offer free trials? first appeared on Easy Digital Downloads.

Once WP Super Cache is activated, go to Settings > WP Super Cache and then click on the Advanced tab. In the Miscellaneous section, there are two options that should be checked:

1. Don’t cache pages for known users. (Recommended) – This is primarily for logged-in users.
2. Don’t cache pages with GET parameters. (?x=y at the end of a url) – This will ensure that the checkout page and cart widgets work as expected.
3. Since WP Super Cache v1.3.1 – Dynamic cached content – This must be enabled in the Advanced Settings section.
4. Add /checkout/ to Rejected URIs option.

You can see a screenshot of the settings below:

Rejected URIs example:

The post WP Super Cache first appeared on Easy Digital Downloads.

Before asking for a refund, please allow us to try and resolve any difficulties you are experiencing by  opening a support ticket.

A few small points:

1. We will process your refund as soon as we’re able to. In some cases we might ask you for the opportunity to resolve the issue for you.
2. Refunds may only be issued within 14 days of the purchase date. After 14 days no refunds can be processed.
3. We reserve the right to deny refund requests if we deem it necessary.
4. We cannot cover any differences in exchange rates between the time you purchased and the time you are refunded.

If you require a refund and your request fulfills the requirements above, you may submit a Refund Request.

The post Refund Requests first appeared on Easy Digital Downloads.

Here is a list of files WordPress allows you to upload: https://codex.wordpress.org/Uploading_Files

If you want to sell a file not supported by WordPress you have a couple options:

1. Compress the file to .zip
2. A plugin like WP Add Mime Types allows you to specify additional files types you can upload to WordPress.
3. Use the Amazon S3 or Dropbox extension.
4. Upload your file via FTP. Follow the steps in this guide: How can I use files that are too large for WordPress to upload?

The post What file types are supported? first appeared on Easy Digital Downloads.

Cloudflare

Easy Digital Downloads works with Cloudfalre’s services, however, there are some settings and suggestions we have. You can view our extensive Cloudflare documentation to ensure your store works with this service.

WP Super Cache

WP Super Cache is one of the most popular caching plugins available. It is fully compatible with Easy Digital Downloads, though if you wish to use it, there are a couple of configuration options you must enable in order for it to work fully.

Once WP Super Cache is activated, go to Settings > WP Super Cache and then click on the Advanced tab. In the Miscellaneous section, there are two options that should be checked:

1. Don’t cache pages for known users. (Recommended) – This is primarily for logged-in users.
2. Don’t cache pages with GET parameters. (?x=y at the end of a url) – This will ensure that the checkout page and cart widgets work as expected.
3. Since WP Super Cache v1.3.1 – Dynamic cached content – This must be enabled in the Advanced Settings section.
4. Add /checkout/ to Rejected URIs option.

You can see a screenshot of the settings below:

Rejected URIs example:

WP Fastest Cache

In order to use WP Fastest Cache with Easy Digital Downloads, there are quite a few settings to change. This is a basic list of the settings that need to be configured.

Settings

Logged-in Users: Enabled. This
Preload: Disabled
New Post: Enabled
Updated Post: Enabled
Combine Js: Disabled. This setting frequently causes the JavaScript from EDD to be malformed when updates are made, sometimes causing checkout and adding to cart to fail.

If you are using the Free Downloads Extension, please enable the ‘Mobile’ checkbox, as this will prevent your mobile users from being shown the desktop version of the free downloads form.

Exclude

Add rules to the Exclude section for:

Exclude Pages:

Your checkout page. By default this is `checkout`

Purchase Confirmation page. By default, these URLs contain the `purchase-confirmation` slug.

Note: If you have renamed the default checkout, purchase confirmation, or purchase history pages, you’ll need to use their page URLs here instead of the defaults.

Exclude Cookies:

In order for EDD’s cart to wor,k you’ll need to exclude the `edd_items_in_cart` cookie.

To make sure that cart errors are not cached, exclude the cookie `edd_cart_messages`

Once a purchase is complete, make sure the purchase confirmation isn’t cached by excluding the `edd_purchase` cookie.

If your site uses fees in any way, exclude the `edd_cart_fees` cookie.

In order to support cart recovery, exclude the `edd_resume_payment` cookie.

Make sure the cart itself isn’t cached by excluding the `edd_cart` cookie.

If you are using discounts, be sure to exclude the `cart_discounts` and `preset_discount` cookies.

Exclude JS:

To make sure that the JavaScript file for EDD’s Checkout is always the most up-to-date, you’ll want to exclude it from the cache. Not excluding could prevent your site from allowing customers to checkout when EDD is updated.

If you continue to have issues with WP Fastest Cache with these settings, please reach out to the WP Fastest Cache support team directly at https://www.wpfastestcache.com/contact-us/

WP Engine

If you are hosting your website with WP Engine, you can add Custom Cache Exclusions using your administration panel.

WP Engine provides a documentation article https://wpengine.com/support/cache/#Custom_Cache_Exclusions on how to exclude items from the cache.

In some cases when passing the “discount” parameter in the URL, the discount code is not being added to the Checkout page once the customer reaches it. For that to work, you need to add the “discount” argument as an exclusion, following the steps listed in the article above.

It would need to be added in the format: arg: discount=

Following the same example, you can add other arguments for being excluded from their caching.

Kinsta

For users hosting with Kinsta, it is possible that the Checkout page session data to be cached. The way to fix it is from your hosting account Tools panel by enabling “Remove Set-Cookie headers”.

Cloudways

The Cloudways Breeze plugin for WordPress allows you to exclude certain pages from Caching.

In the Never Cache URL(s) field, add the following (one per line). Note that these URLs might need to be adjusted depending on the slug of the actual page on your website.

/cart
/checkout
/purchase-confirmation

Inside your Cloudways account, under Varnish Settings (for your specific application), add custom exclusion rules so that if any of the cookies at the end of this article are detected, Varnish bypasses the cache.

Also, add the dynamic URL exclusions (same as Breeze above) to ensure these pages aren’t cached by Varnish.

Spider Cache

There are no known conflicts between Spider Cache and Easy Digital Downloads. Spider Cache has undergone extensive testing with Easy Digital Downloads, conducted by the Spider Cache lead developer.

W3 Total Cache

In order to use W3 Total Cache with Easy Digital Downloads, there are a few settings you need to ensure are setup correctly. This is a basic list of the settings that need to be configured.

General Settings

Page Cache: enabled with Disk: enhanced
Minify: disabled
Database cache: disabled
Object cache: disabled
Browser cache: enabled
CDN: enabled (this does not affect EDD)

Object Cache

Global Groups:
users
userlogins
usermeta
user_meta
site-transient
site-options
site-lookup
blog-lookup
blog-details
rss
global-posts

A list of Cookies that EDD uses can be found below:

A complete list can be found below:

edd_items_in_cart
edd_session_*
edd_cart_messages
edd_purchase
edd_cart_fees
edd_resume_payment
edd_cart
cart_discounts
preset_discount
edd_cart_token
edd_saved_cart

This is not an exact list and there will definitely be variations, but this is the config that has been shown to work. If you find other options/variations that work or don’t work,
please contact us via support. We will update this doc as needed.

The post Configuring Cache for Easy Digital Downloads first appeared on Easy Digital Downloads.

Generally speaking, Easy Digital Downloads is compatible with Cloudflare, however, given the complexity of eCommerce stores, there are some features and configurations you’ll want to ensure you account for, when using the service.

As always, when optimizing site performance, when changes are made to optimization features in Cloudflare, we strongly encourage you to test the critical areas of your site as a logged out user to ensure functionality is not affected.

Automatic Platform Optimization for WordPress (APO)

The Cloudflare Automatic Platform Optimization feature (or APO) is a feature that can improve the performance of your site by reducing the time to first byte (TTFB). The APO feature supports many popular WordPress plugins, including Easy Digital Downloads.

To enable Automatic Platform Optimization, you first need to install and activate the Cloudflare WordPress Plugin

Once activated, head to Settings > Cloudflare. You will need to either create a free account or if you have an account click Sign in here

You will need the email address used for your Cloudflare account, as well as your Global API Key, which can be found by clicking on the link below the form

This will open a new window where you click on the API Tokens menu, where you can click on the View button for your Global API Key.

After you have connected your site to Cloudflare, you can turn on the Automatic Platform Optimization from the Settings > Cloudflare > Home settings within your WordPress admin area.

We recommend using the Cache By Device Type setting be enabled to ensure the best user experience.

Rocket Loader

Cloudflare’s Rocket Loader feature, improves page load performance by loading all Javascript asynchronously, even 3rd party scripts. This can help your pages load faster and allow customers to interact with the site more quickly

When enabled the Rocket Loader feature can cause issues with EDD’s checkout as it can cause duplicate payments to be created at the Gateway due to it duplicating the click to process a purchase. To ensure your checkout is not affected by this undesired result, you should disable Rocket Loader on the checkout page using a Configuration Rule. To enable a Configuration Rule, in the menu on the left of your Cloudflare domain settings, choose Rules > Configuration Rules

Once there, click ‘Create rule’

Then configure a rule that turns off ‘Rocket Loader’ on the checkout page. Our example uses the default checkout page of /checkout

Scroll down and click ‘+ Add’ for Rocket Loader, and ensure that it is ‘Off’

Then click ‘Deploy’

ScrapeShield

Cloudflare’s ScrapeShield technology grabs the email address of the customer and obfuscates it so that spammers cannot scrape it and send spam.

The drawback to this is that it’s then not a valid email address, and the customer becomes disconnected from the purchase.

Cloudflare offers instructions on how to turn off this feature.  Once it’s off then the issue is resolved.

HTTPS Protocol Rewriting

This option attempts to make all of your site’s assets (like CSS files etc) load over the same protocol (http or https).  Occasionally it doesn’t load properly, causing downloads to be served without contents, so the filesize is 0.  You can turn this feature off in your Cloudflare panel,  Cloudflare’s documentation on HTTPS Protocol Rewriting explains how.

Page Rules

Cloudflare has a number of performance tools, and in order for your EDD Store to run well with Cloudflare you may need to adjust some Page Rules in order to ensure that adding to the cart and processing orders complete successfully.


These are the suggested page rules that you should add to your Cloudflare account to ensure optimal functionality.

• domain.com/checkout*
  • Cache Level: Bypass
  • Browser Integrity Check: Off
  • Rocket Loader: Off
• domain.com/admin-ajax.php
  • Cache Level: Bypass
  • Browser Integrity Check: Off
• domain.com/wp-json/edd*
  • Cache Level: Bypass
  • Browser Integrity Check: Off

Payments not marked as complete

If you are experience problems with your payments not being marked as complete (usually only happens with ‘offsite’ payment gateways like PayPal) and you use CloudFlare on your website, try disabling CloudFlare temporarily to see if payments are properly marked as complete when it is disabled.

You may need to exclude your checkout page from Cloudflare’s caching. Here is one of their help articles to get you started with that: 
https://support.cloudflare.com/hc/en-us/articles/200172316-How-do-I-exclude-a-specific-URL-from-CloudFlare-s-caching-

The post Does Easy Digital Downloads work with Cloudflare? first appeared on Easy Digital Downloads.

http://example.com/downloads/downloadcategory/nameofdownload

If you need this functionality there’s an excellent plugin on CodeCanyon called EDD Permalink. This plugin can accomplish a URL similar to the one above.

The post Category in Download URL first appeared on Easy Digital Downloads.

General Issues with EDD and Caching

Software Licensing

The Software Licensing extension works by having your software communicate with your EDD store over an API. That Software Licensing endpoint can get cached by any of the common caching plugins. This will cause problems when checking licenses.

The fix for this issue is to simply not cache anything in the Software Licensing directory.

If using WP Rocket you can use this pattern to exclude the proper things: /edd-sl/(.*)

If using WP Super Cache, choose the setting Don’t cache pages with GET parameters. (?x=y at the end of a url)

Specific Issues with Caching Plugins

Each caching plugin has its own issues, here are docs for each one.

• W3 Total Cache
• WP Super Cache
• Hyper Cache
• WP Fastest Cache

The post Caching Issues first appeared on Easy Digital Downloads.

General Settings

Page Cache: enabled with Disk: enhanced
Minify: disabled
Database cache: disabled
Object cache: disabled
Browser cache: enabled
CDN: enabled (this does not affect EDD)

Object Cache

Global Groups:
users

userlogins

usermeta

user_meta

site-transient

site-options

site-lookup

blog-lookup

blog-details

rss

global-posts

This is not an exact list and there will definitely be variations, but this is the config that has been shown to work. If you find other options / variations that work or don’t work,
please contact us via support. We will update this doc as needed.

The post W3 Total Cache Config first appeared on Easy Digital Downloads.

By default, your products will display in a grid layout with three columns, nine products, and pagination if you have more than nine products in your store. In most themes, this display serves its purpose just fine without any additional CSS (design styles) from the theme itself. However, it may not look exactly the way you want it to in all themes. Even worse, the display may become distorted on smaller screens.

This typically leads to the question, “is the [downloads] shortcode responsive?” In other words, people often wonder why the display doesn’t look so great on small screens. I’ll explain why, and what you can do about that below.

Why isn’t the [downloads] shortcode responsive?

The first thing to note is that responsiveness is not a one-size-fits-all type of behavior. The responsiveness of an element depends entirely on the environment in which it is contained.

For example, let’s say there’s a section of your site with two side-by-side columns filled with text, both spanning 50% of the width of your main content area. Let’s also say that the main content area “holding” those twin columns is 1000px wide. That means each column is 500px wide. As the screen width becomes more narrow on smaller devices, somewhere around a 600px content area width starts to make the now-300px columns a little too slim. That’s undesirable, so responsive CSS uses rules to say, “at 600px screen width, change the width of these two columns from 50% to 100%, and stack the left one on top of the right one.” And with that, they both become legible once again.

That’s exactly how responsive CSS works, and it is done with intent.

With that understanding, it becomes clear that in order to write the responsive CSS to make those twin columns “respond” to the screen width, we must also know the dimensions of the elements around the columns. In the WordPress context, that means we need to know the design and dimensions of your theme.

Of course, we cannot know the details of all the themes our customers may use. While your theme may output the [downloads] shortcode in an element that is only 500px wide, the next person’s theme may output the same shortcode in an element that is 900px wide. Your responsive CSS would need to be a lot different than the other person’s responsive CSS. And if you switch themes, your responsive CSS would need to change once again.

To put it another way, we simply cannot predict when and how the [downloads] shortcode should respond to every theme all at once.

Are there themes that include responsive CSS for the [downloads] shortcode?

Yes indeed! In most themes that are built to take advantage of EDD, this is already done for you. For example, the Vendd theme fully designs the [downloads] shortcode output for all screen sizes. You can see it on the demo here: https://easydigitaldownloads.com/vendd/ Not only does Vendd make the [downloads] shortcode responsive, but it also enhances the layout.

If a theme was not enhanced with EDD in mind, the output of the shortcode will not be responsive. It will display as specified by the shortcode parameters and nothing more. If you need it to “respond” to screen size, that must be written from the perspective of your theme specifically.

Also, note that some themes that are enhanced for EDD still may not make the [downloads] shortcode responsive. Instead, it will include its own template for displaying products and suggests that you use the custom template instead of the shortcode.

There is a large selection of EDD-ready themes available here: https://easydigitaldownloads.com/themes/

What should I do if I am not using an EDD-ready theme?

If you would like to continue using your theme that is not enhanced for EDD, but you would also like your [downloads] shortcode output to be responsive, you have two options:

1. If you are a CSS author, you can simply write responsive CSS to make the shortcode output do as you please from your theme. You will not need to worry about EDD making any changes that will break your CSS.

2. Hire a designer to make the output responsive for you. It’s not an incredibly difficult task so the designer would not need to be familiar with EDD itself. Responsive CSS is a widely understood design style and just about any CSS author should be able to view the output and make it responsive for your theme. If you would like to stick to a professional that is already familiar with the EDD ecosystem, we recommend our trusted partner, Codeable.

The post Is the downloads shortcode responsive? first appeared on Easy Digital Downloads.

The post Can I run WooCommerce and Easy Digital Downloads at the same time? first appeared on Easy Digital Downloads.

Download Failed: Unauthorized

1. Expired License

This is happening either because the license key is expired or it is not activated on the URL the extension is installed on. This can sometimes happen if you install the plugin and activate the license key on a temporary URL and then update the site to the final URL.

• How do I renew an existing license key?
• Policy: License Renewals
• How do I get updates for extensions?
• Updates don’t show up for my extensions

Once your license is up to date automatic updates should resume without issue.

Download failed. Too many redirects and/or Download failed. Unauthorized

If you (or a customer) see this when attempting to update a plugin, confirm there is a file selected in for ‘Update File’ in the Licensing metabox in the product settings.

Example of error: “An error occurred while updating : Download failed. Too many redirects”

See Too many redirects on a download for more details on this error.

The post Download Failed: Unauthorized first appeared on Easy Digital Downloads.

The email address 'bob@example.com' is already in use.

If a WordPress account is created for a customer on checkout for a past purchase, they need to be logged in to complete future purchases. For security, a logged-out user should not be able to make changes to an existing account, including adding orders to an account.

To avoid the message, enable guest checkout but disable automatic registration. Although, existing users will need to log in to make a purchase, any customer without a WordPress account will be able to purchase without logging in.

Legacy issues (EDD 2.7 and earlier only)

The issues below should no longer be an issue and only affects stores that were built prior to 2018, EDD version 2.7 and earlier. If your store was built in 2018, the issues below will not apply.

Customer must login to complete payment. Why?

Since the release of version 2.7, Easy Digital Downloads has included the ability to recovery abandoned or pending purchase records. If the user’s browser is still in its purchase session, the product will remain in the cart for the user. Likewise, a Recovery URL section is added to the admin purchase record, allowing site admins to easily share the link with a user in the event his or her purchase session has expired.

If the user has never purchased before, the process is smooth. Using either the recovery URL, or continuing the purchase session, the user can continue on with the purchase as if nothing ever happened.

However, if this user, identified by the email address entered at checkout, has made a purchase before, that abandoned or pending purchase record is now attached the that user’s customer record and can
only be recovered by him or her.

In the event that a logged out user attempts to recover a purchase that is tied to an existing customer record, a notice similar to this will display on checkout:

This notice means that the purchase record used to populate the checkout cart is directly tied to an existing customer record, meaning the email address entered by the person attempting to check out matches an email address from at least one past purchase.

Let’s go over a few quick solutions to overcome this notice based on scenario.

I’m the site owner and I’m facing this notice while testing

If you are the site owner and you have logged out of your site in order to test the purchase process for a guest, there is a chance that you have used the same email address for testing that you already have attached to your live account. That means, in your testing, you are trying to recover a purchase record (as a guest) that is now officially attached to your live account. That will cause you to see the notice.

You can even log into your site from another browser, view the abandoned/pending purchase record from admin, and see that it is already attached to your customer record. In this scenario, the notice is accurate. If you would like to test the guest purchase process, please do so using an email address that is not already attached to a customer record in your store.

One of my customers has reported this notice to me

This scenario is the same as above, except it may be more of an edge case. Chances are, you allow guest checkouts on your site, which is fine. However, even when someone checks out as a guest, a customer record is still created based on the email address used at checkout.

In theory, a customer can make 10 separate guest purchases over the course of a year, using the same email address each time, and each purchase will still be attached to a single customer record. 

This is desirable, and good for your system. However, if that repeat customer attempts to make an 11th purchase, abandons the purchase for whatever reason, and then attempts to recover it either through browser session, or because you provided a recovery URL, he or she will have to login to complete the purchase. This proves to the system that the rightful owner of that particular purchase record is completing the purchase.

This scenario is rare, but it can happen.

Note: we have concrete plans to make the recovery process a little smoother so that store owners can run a store that fully supports guest checkout in all scenarios. If you still see this note, the change has not been made yet.

The email address is already in use appears for logged in users

This happens because of a bug in older versions of Easy Digital Downloads that allowed multiple customers to be attached to the same user account.

This bug no longer exists, but if multiple customers were already attached to the same user account before the bug fix was released, their issue still exists.

The solution

The problem is resolved in EDD 2.6 and later, but if there are issues with connected accounts from previous versions you’ll still see an error message alerting you about it. Here’s how to fix it.

Find the WordPress user

Go to the Users section of the WordPress admin. In the top right is a search field. Put the problem email address into that field and search.

Then click on the username to edit the user. The URL will contain the ID of that user.

Find the conflicting customers

Take the user ID from the above search and go to Downloads → Customers. In the top right is a search box. Search for the user ID with a search string like this:

user:2

Replace 2 with the number you found in your own search. The results should be 2 or more customers.

Move purchase records

To resolve the conflict you must move all purchase records from one customer to the other, then delete the empty one. Pick the customer you want to delete and click the Name to edit.

On the edit page you’ll find a Recent Payments box. Click View Details on each payment.

When editing a payment, you’ll see a Customer Details box. Choose the other customer and press save.

Repeat this until there aren’t any more purchase records. Once the Customer has no purchase records then you can click the trash can in the top right of the Customer record and delete the user.

Add the email address to the remaining user

Once the offending customer has been deleted, add the email address from that customer to the remaining customer. While editing the customer look for the
Customer Emails section. Add the email address there and then that customer will be associated with both addresses.

At this point the issue should be resolved.

The post The email address is already in use / Customer must login to complete payment first appeared on Easy Digital Downloads.

How To Sell Physical Things With Easy Digital Downloads

First you’ll want the Simple Shipping extension.

• Download Simple Shipping
• Documentation for Simple Shipping

Once you’ve followed the instructions in the documentation you’re ready to go. You’ll realize that the name of the extension is quite serious, this is for VERY simple shipping.

When This Is A Good Idea

There are times when it’s a good idea to have a physical item in your digital store. Here are some example.

• Physical liner notes for a digital album
• An article of clothing for fans of your primary product
• Any time your primary product is digital, and your physical item is a minor offering

Case Studies

• A band with 65 single mp3s, 4 albums, and 1 Tshirt
• A software company with 5 plugins and a plush mascot

When This Is A Bad Idea

If your primary product is physical then a digital sales platform is a bad idea. Here are some examples of where selling physical things with EDD is a bad idea.

• You sell Flashlights and have digital documentation
• You sell CDs and offer mp3s as a free addon
• You sell video games on DVD and offer demos for download

As you can see above, the primary products are physical. EDD probably isn’t a good fit here.

The Rule Of Thumb

If the majority of your products are digital you should look carefully at EDD. If the majority of your products are physical, you should probably look at another eCommerce package.

The post Can I sell physical products with Easy Digital Downloads? first appeared on Easy Digital Downloads.

Because user accounts are managed by WordPress itself (as opposed to with Easy Digital Downloads), this means that it is a problem we’ll solve at the WordPress core level. 

In this document, we’ll look at 2 different ways to show a WordPress log-out link. Note that there are many other ways to do this – but for the sake of simplicity we’ll only look at 2. 

Option 1: Use a log-in/log-out plugin for WordPress

There are many plugins for WordPress which will display log-in and log-out buttons on your website. One of the most popular ones for this is called “Baw Login Logout Menu”.

It makes it possible/easy to add log-in and log-out buttons right in your WordPress menu. 

To set it up, follow the instructions found under “FAQ” on that plugin’s page. 

Option 2: The logout button already included on the WordPress header bar. 

WordPress automatically shows a black bar at the top of every page if you are logged in. At the right side of the bar, it always displays a log out option. Your customers/users can use that option as long as you haven’t hidden that bar in some way. 

The post How can I show a “Log Out” link to my customers? first appeared on Easy Digital Downloads.

When the customer creates a new WordPress account and they have made a past guest account they’ll see a notice that their account needs to be verified, with a link to send an email for verification.

Note: This feature does not affect all customers or purchases. Accounts only require verification if the user who has registered the account has made purchases on their account email prior to registering the account. If there are no purchase records on the email when the account is created, no verification process will be required.

Once the customer clicks the above link they’ll see another alert that their account is pending verification, asking them to click the link in their email.

Once the customer has clicked the link in their email, they’ll be able to log into the web site normally and they’ll see their full purchase history.

FAQ

How do you disable User Verification?

The account verification system is a critically important security feature which helps to ensure the security of your customer’s accounts. In the same way that super simple passwords (like “12345”) and basic user names (like “admin”) are often not permitted, this feature cannot be turned off even by a site admin. Disabling it would immediately compromise the security of your users’ accounts.

The post User Verification for Easy Digital Downloads first appeared on Easy Digital Downloads.

File download method

In the Misc tab of the Easy Digital Downloads’ settings page (Downloads → Misc → File Downloads), there is an option called “Download Method”. This can be set to either Redirect or Forced. See our FAQ on this setting for an explanation of the difference.

The easiest way to make files download instead of playing in the browser is to set the Download Method to
Forced. That will resolve it in most cases.

In some cases using
Forced will result in corrupted files. If this occurs, see alternative options below.

Serve files through Amazon S3

Amazon S3 is one of the most popular and reliable file hosting / delivery services available. If using the Forced download method is not an option for you, or you simply want an incredibly reliable and secure file delivery system, Amazon S3 is an excellent option. Our Amazon S3 extension makes it easy to connect to your S3 account and will handle file delivery in a secure, reliable manner that will also force files to download instead of playing in the browser.

Serve files through Dropbox

Dropbox is an incredibly popular file hosting / syncing service used by millions. It can also work very well for reliably and securely hosting files sold through Easy Digital Downloads. Our Dropbox File Store extension lets you easily connect your store to Dropbox and will resolve all issues with files playing in the browser instead of downloading.

The post Videos / songs play in the browser instead of downloading first appeared on Easy Digital Downloads.

Our support team is more than willing to help track down issues. However, because no two WordPress sites are exactly alike, there is always a chance that troubleshooting directly on your site will reveal the cause of the issue.

To resolve issues as quickly as possible, try using the trusted troubleshooting tips and techniques below.

Check for plugin conflicts

A plugin conflict happens when two separate plugins are activated at the same time and either of them experiences unusual behavior because of how it interacts with the other. The interaction may not always be obvious, so there is no room for assumption. Any two plugins can conflict with each other.

To check for a plugin conflicting with EDD, follow these steps:

1. Temporarily deactivate all plugins besides EDD and, if applicable, a particular EDD extension that is experiencing an issue. It is important that you do not assume that certain plugins cannot conflict with the EDD ecosystem. For proper testing, deactivate them all.

2. Check to see if the original problem persists. If it does, there is no plugin conflict and you can stop here. If it does not persist, you have a plugin conflict. Move to step 3.

3. Reactivate your plugins one by one. After each reactivation, check the functionality once more to see when the issue presents itself again. As soon as the issue returns, the last plugin you activated is conflicting with EDD (or its extension).

4. Determine the importance of the other plugin. If it is not something that you actually use, simply get rid of it. If you do use it, attempt to track down if there is a particular setting that triggers the conflict. The more information you can gather in this stage, the better.

5. Once you’ve gotten as far as you can with troubleshooting, contact support with the information you’ve gathered. https://easydigitaldownloads.com/support/

Check for theme conflicts

While theme conflicts are a little less common, they still happen from time to time. Checking for a theme conflict is simple. Follow the steps below.

1. Temporarily switch your WordPress theme to a default theme like Twenty Sixteen or Twenty Seventeen, as these are considered standard themes in the WordPress environment. 

2. Check to see if the issue persists. If it does, there is no theme conflict and you can stop here. If it does not persist, you have a theme conflict. Move to step 3.

3. At this point, it still may be hard to say whether there is a problem in EDD or in your theme. Use your best judgment to choose a path, and contact either our support or your theme developer’s support to describe the issue.

The post Helpful tips and troubleshooting techniques first appeared on Easy Digital Downloads.

This error can also happen during the file download part of update installations.

Fix

The problem is that the “Update File” dropdown is set to “No update file selected”. Select an Update File and click “Update” in the Publish box to save the settings for the product.

Once a file is selected, the update will work.

In the event selecting an update file doesn’t work, follow these steps:

1. Delete all files from the “Download Files” section
2. Click the Update button in the Publish box
3. Attach a new download file without changing the default File Name
4. Click the Update button in the Publish box
5. Rename the File Name for the download
6. Click the Update button in the Publish box

NOTE: Updating the Download after each step is important, do not skip those steps.

The post Too many redirects on a download first appeared on Easy Digital Downloads.

During Checkout

You can enable the registration and login forms on the checkout page.  Under Downloads > Settings > Payments > Checkout site owners have the option of including the login form, the registration form, or both on the checkout page.

When the above option is set to show both the login for and the registration form then checkout will look like the one below.  Note the Login link at the top and the registration form at the bottom.

Anywhere On Your Site

If you’d like to allow your customers to log in at any time you can use the shortcode [edd_login] to render a login form. More documentation on [edd_login] here.

If you would like your customers to simply be able to create an account before purchasing or browsing the site you may use the shortcode [edd_register] and it will create a form for registration. See image below.  More documentation on [edd_register] here.

Customer Account Page

For more information on creating a complete Customer Account page, please read the Creating a Customer Account Page document.

Customer’s Wordpress User Role

When a customer registers they are assigned to the Wordpress default new user role. To verify or change go to the Wordpress Settings > General and update “New User Default Role”.

The post Can customers create accounts? first appeared on Easy Digital Downloads.

As an Easy Digital Downloads (EDD) user, there is a chance you have to want to adjust your product presentation to fit the needs of your store and your customers. In this article, we’ll cover how EDD presents your products by default as well as the various ways you can control that presentation.

Note: The /downloads page is not a page but a WordPress archive. This is why you don’t see it under your list of WordPress Pages.

Simplest Solution for most users

Before we get into too much detail if you are just looking for a way to display all of the products you have created in a simple fashion, create a new page, ie Store, and use the EDD Products block or [downloads] shortcode. It can be placed directly on a new page without any additional configuration.

Now, on to the more technical stuff.

Default Download Archives

For those of you using the “Post name” permalinks selection in your WordPress settings (most likely everyone), a default product archive is created for you automatically once you have created at least one product in your system. You can see this page by visiting yourdomain.com/downloads in your browser.

Please understand that this page is not intended to be your store. It is not something that EDD creates for you as a store. Instead, it is there because of how WordPress treats certain post types. This does not mean you cannot control the display of this archive. It just means EDD expects you to use the [downloads] shortcode as your most basic display of products, not the download archives. We will, however, cover how to control this archive.

WordPress uses a template hierarchy in the active theme (or its parent theme if a child theme is activated) to determine which template should be used to display different types of pages on your site. After a certain type of template file is chosen, in this case, an archive template, WordPress will use the names of the existing templates to choose which one is the right choice.

Most WordPress themes include a archive.php file. It is typically used for things like author, date, and taxonomy archives. It is also used for custom post type archives, which is what EDD’s Download is.

Custom post type archives have a very simple hierarchy in regard to template files:

1. archive-{post_type}.php – If the post type is book, WordPress will look for archive-book.php.
2. archive.php
3. index.php

If a template file named specifically for a custom post type is present, WordPress will use it. Otherwise, it will use the common
archive.php or ultimately fall back to the required index.php file.

Unless your theme was built specifically for use with EDD, there’s a chance it has a archive.php file and no archive-download.php. That means your theme will use the generic archive.php template to display products when you visit yourdomain.com/downloads in your browser.

While this generic display may be okay for author or date archives, it isn’t always a good fit for download archives. Instead, you would need to create an archive specifically for Downloads.

archive-download.php

If you place a file called archive-download.php in the root directory of your active theme, WordPress will use it to render yourdomain.com/downloads. That is pretty straightforward. However, what you build into this file is up to you.

If you are a theme developer, you should be familiar with how to build the various template files. You can use our sample product grid to jumpstart the development of your download archive. If you are not a theme developer, this is something you would need to hire someone for. How to develop an archive is less about EDD and more about WordPress and general development. That is outside the scope of this documentation.

If you are not a theme developer but you are hands-on, there are several theme examples you can use to grasp the concept of creating a custom archive for your downloads. The best reference would be our
Vendd theme, which you can also find on GitHub for easy access to the codebase.

The post How to edit the Download (Archive) Page first appeared on Easy Digital Downloads.

In this guide, we’ll cover:

Checking the Order’s Deferred Actions
Verifying emails are sending
Confirming emails are not in SPAM
Logging sent emails in WordPress
Using a third party for email delivery

Easy Digital Downloads relies on the WordPress core Cron functionality to send emails so that it does not impact the performance and reliability of completing the purchase process.

Check the Order’s Deferred Actions

First, emails will not be sent until the Order is Completed. Next, Deferred Actions are the actions that take place as soon as the order is completed, which includes sending the email receipt and notification. One of the actions is to schedule an event to send the order-related emails 1 minute after the order is marked as completed.

Check the Order Details to see if the Deferred Actions is Completed, if not, that is an indication there is an issue. This process should take 1 minute but could take a couple of minutes depending on external factors, so wait 5 minutes before assuming it’s not working.

If the Deferred Actions are Scheduled (for more than 5 minutes) or Not Run, most most likely cause is Cron is not working. To confirm, install the WP Control plugin can confirm:

1. No error message at the top of the WP Control table indicating cron is disabled or not working
2. No cron events that are reporting “missed schedule”.

If either is occurring, you’ll need to reach out to your hosting company for assistance. It’s possible they are limiting cron and will need to address it.

As a workaround, you can remove the Deferred Actions for emails by using the following snippet:

add_filter( 'edd_use_after_payment_actions', '__return_false' );

The best way to apply the code snippet to your site is with a plugin that allows you to add custom code to your site. To do that, we recommend using WPCode. Click here to learn how to apply the snippet using WPCode.

This will reinstate the immediate sending of email, however, this will remove any performance benefits we’ve gained in the checkout process related to sending emails. Therefore, it’s recommended you work with your hosting company to get cron working.

Verify emails are sending

A quick test to see whether any of your WordPress emails are being sent is to go to your WordPress login page and click on “Forgot Password”. If you do not get the email sent there, this shows that none of your emails are being sent from WordPress. To solve this, you’ll either need to reach out to your webhost to see why your WordPress emails are not being sent, or switch your email sending to be powered by a 3rd party. To learn more about that, see the section on this page called “Using a third party for email delivery“.

Checking your SPAM or junk folders

Before assuming that your website is failing to send emails, it is very important to ensure they are not being sent to your spam or junk folders. Check your email account’s spam and junk folders as well as all custom message handling rules you may have configured to verify emails are not just missing your inbox. Attempting to send the emails to additional accounts will help further confirm whether the source of the problem is on the sending or receiving end.

If you do find emails sent by your site in your spam folder, you may want to consider using a third-party email delivery service that will improve the reliability and deliverability of your messages. Read more below about using a third party to deliver your site’s emails.

If emails are actually sent but are not ending up in the recipient’s inbox, it is possible that the sending domain has been blacklisted and the messages are being rejected.

To find out if your domain has been blacklisted, enter your domain name into one of these services:

• MXToolBox
• What is my IP address
• Black List Alert

If you do discover that your domain has been blacklisted, you will need to work directly with the blacklist(s) in question to request removal. In some cases, this is as simple as filling out a form on their site. For others, the process is a little more complex and time consuming.

Logging sent emails in WordPress

Within your WordPress site, it is possible to keep a record of emails that are triggered. This does not conclusively verify that the email was sent successfully but it does mean that the site recognized the requirement to send an email and processed the necessary functions to do so.

There are also free email logging plugins available on the WordPress plugin directory such as WP Mail Logging. After loading the plugin, test an order or wait for a live order to complete and confirm the email receipt is logged.

Using a third party for email delivery

Reliable email delivery is incredibly important for eCommerce sites. Unfortunately, non-reliable email delivery is a common problem with cheaper and low-end hosting accounts. See our detailed blog post on the subject. Depending on your hosting account to manage email delivery is not a good idea, especially as hosting accounts are often affected by a number of limitations:

• Low sending limits, sometimes less than 250-500 emails per month
• Slow email processing, resulting in delayed delivery
• Poor support for modern HTML emails, resulting in frequent delivery failures
• Overly aggressive spam filters, resulting in emails getting improperly flagged as spam
• Shared email servers, meaning other accounts with the same company can negatively impact your service

These limitations can frequently result in your emails not working. To resolve the problem, you need to connect your site to a dedicated email delivery service.

We recommend WP Mail SMTP, which is directly integrated into Easy Digital Downloads.

See this article for details on using an SMTP service.

Also, see How to Fix WordPress Not Sending Email Issue for additional assistance and tips.

The post Why are email receipts and/or sales notifications not being sent? first appeared on Easy Digital Downloads.

This setting is located in Downloads > Settings > Misc > File Download.

Forced

With the forced method, Easy Digital Downloads breaks the file into smaller pieces and delivers them to the browser without redirecting the user to the actual file. This is beneficial for advanced hosting configurations where files may not be stored in the default directories, or delivered via a content delivery network (CDN).

Due to its consistency in multiple platforms and better file protection, ‘forced’ is the default method.

Because Easy Digital Downloads uses PHP to process the file with the ‘forced’ method, larger files can cause problems with delivery, resulting in hitting the ‘max execution time’ of the server. If user’s are getting 404 or 403 errors when trying to access their purchased files when using the ‘forced’ method, changing to the ‘redirect’ method can help resolve this.

Redirect

The Redirect method is the most straight forward of the two, and works by telling the user’s browser the location of the file, and it then starts the process of downloading it directly from the server. This method of delivering files is best suited for use when certain server configurations do not support the Forced (default) file delivery method, or files are being hosted by a 3rd party (Amazon S3 or Dropbox) that does not support the Forced method. If you do need to use the ‘Redirect’ method for self hosted files (files in the /edd/ directory), it’s advisable to use the ‘Symlink’ option if possible.

The redirect method without symlink, while self hosting files, could result in customers who are downloading files to see the direct path to the file, so the above recommendations should be used.

This does rely on the browser to handle the bulk of the work, and depending on browser configuration can result in unexpected results for some filetypes.

It’s best to use the ‘redirect’ method for large files. Also, we recommended hosting large files on Amazon S3 or Dropbox. 

Note: The symlink setting does not apply to Amazon S3 or Dropbox.

The post What is the difference between Forced Download and Redirect Download? first appeared on Easy Digital Downloads.

The goal here is to not only answer your questions, but also give tips to those who want to make adjustments on their own.

Will EDD work with my theme?

Short Answer

Yes. EDD is designed to work with any theme.

Detailed Answer

Absolutely. However, there are things that can be done to help your theme get more out of EDD and its extensions, though they are not required.

For details on theme-specific enhancements, view the Related Articles section at the bottom of this doc. For now, let’s cover the basics.

How does EDD work with any theme?

The first thing we have to do is define “work.” It is important to separate the differences between functionality and style.

Functionality

Functionality, in this context, is what gives you a full eCommerce platform. Everything from creating product pages to sending customers to a purchase confirmation page after a transaction is how EDD functions.

That functionality, for the most part, is behind the scenes. However, certain functionality requires input from site visitors through button clicks, text input, and more. In order facilitate that interaction, front-end elements (things you see on the site) are displayed on the screen. How those elements look leads us to style.

Style

Style is less about how EDD functions and more about how its front-end elements are presented. Just like with all sites, presentation is the responsibility of CSS. Typically, WordPress holds its CSS in themes because they are responsible for styling WordPress sites. CSS can work from different locations, though. We’ll cover that later.

The important thing to note here is that how EDD front-end elements are styled on your site is not an indication of whether or not EDD works. Functionality is the first priority and the simple answer is “yes,” EDD was developed to function properly with any theme.

Of course, style is important. With that understanding of importance, though, we can move forward.

How will EDD look in my theme?

For many users, what they really want to know is how EDD will look, not how it will function. It turns out this question is a little more difficult to answer.

The easiest way to see how EDD will look in your theme is to test it. Assuming you already have your theme, and considering EDD itself is free, setting up a staging site is by far the best way to get a feel for how things will look once they are set up.

Sometimes EDD looks like it blends right into a theme. Other times certain elements will not display how one would expect them to. Let’s talk about the latter.

Styles from EDD Core

EDD itself includes a CSS file that attempts to standardize certain front-end elements so they do not lose their structure or design in any theme. Components like the checkout form absolutely need to be intuitive right out of the box. So CSS styles are included in the plugin to attempt to secure that structure and design regardless of the theme.

The nature of CSS is to work based on strength and specificity. In this context, that means while EDD core can include its own styles, there is always a chance that any given theme can have CSS with stronger or more specific “rules” than what EDD includes. For those who do have style issues with EDD, this is usually why.

Styles from Your Theme

EDD makes use of a lot of HTML elements that are used all over the web. Keeping with the checkout form example, collecting the names and email addresses of your customers at checkout requires that EDD uses text and email input elements.

Of course, an EDD checkout form is not the only place you will find these types of HTML elements. They are also used in things like contact forms and email newsletter sign-up forms, as well as several other places. Because of that, most theme developers see the value in writing CSS into their themes that will automatically style those generic elements for you.

In some cases, this presents a problem. Perhaps your theme has a heavy design focus on email marketing. For that reason, the theme developer may choose to style text and email input elements to be very large and bold with big text. That makes sense because the email newsletter sign up form needs to grab the visitor’s attention.

What your theme developer did not suspect is that you would be using EDD to distribute your free ebook, for example. Now, your EDD checkout form uses big, bold input elements just to request a name and email address to complete a transaction. In some cases, this is okay. In other cases, the styles applied to checkout form elements work against the flow of the checkout process.

Because of this unpredictability factor, it is always possible that a theme will have a visual effect on EDD elements. Whether or not the effect will be desired can only be determined on a case by case basis (theme by theme).

Page Builders

Page builders can sometimes cause issues, since some of them have their own method of displaying content. This is only a problem with a few page builders though and many will work with Easy Digital Downloads just fine. If you encounter any issues with your page builder or have any questions about one you’re using, please contact support and we’ll be happy to assist you.

Style from the Browser

Lastly, all modern web browsers have their own default styles. If no CSS is written by a designer or developer to force HTML elements to look a certain way, browsers will apply a default style to them. As you would probably guess, not every browser has the same default styles.

It is always possible that a theme will not include styles for certain elements, and those same elements may not be styled in EDD core. When that happens, the browser takes over.

Your Custom Styles

The wonderful thing about web development is that nothing is final. All three style sources mentioned above are what you will start with. However, you are free to change anything you would like. It’s just a matter of knowing how to do it yourself or hiring someone to do it for you.

From your own child theme style.css file, or perhaps a custom CSS plugin like Reaktiv CSS Builder, CSS rules can be written to override any styles that are already applied. This doesn’t always have to be done out of necessity. It can also be done out of preference.

So even though EDD’s styles will be determined by a few different sources, none of those styles have to be final.

EDD Theme Compatibility In Summation

The takeaway is understanding that whether or not EDD will work with your theme is a matter of functionality. How EDD will look in your theme is more of a variable, but steps have been taken to create a base level of consistency across themes.

While some themes are designed for use with EDD, like all of the EDD themes listed here, no theme has to specify EDD support in order for EDD to work with it. You are free to choose your theme based on your own visual preferences.

Please view the list below for more articles on EDD theming.

The post Will Easy Digital Downloads work with my theme? first appeared on Easy Digital Downloads.

In other articles, we’ve discussed how to do things like
create theme templates specifically for product pages as well as editing the downloads archive. Here, we’ll discuss how to take control of the category and tag display for your products.

Download Taxonomy Archives

WordPress uses its template hierarchy to determine which theme template file should be used to display any given page on your site. For taxonomies, or download categories and tags in this context, the template hierarchy is as follows:

1. taxonomy-{taxonomy}-{term}.php – If the taxonomy is sometax, and taxonomy’s term is someterm, WordPress will look for taxonomy-sometax-someterm.php. In the case of post formats, the taxonomy is ‘post_format’ and the terms are ‘post-format-{format}. i.e. taxonomy-post_format-post-format-link.php for the link post format.
2. taxonomy-{taxonomy}.php – If the taxonomy were sometax, WordPress would look for taxonomy-sometax.php.
3. taxonomy.php
4. archive.php
5. index.php

This hierarchy is oftentimes neglected in themes, not because it is unimportant, but because the
archive.php template file is considered a standard and is usually present. On a non-eCommerce site, not too many structural changes are required from a typical date archive display to a post archive display.

However, EDD categories and tags are in the same position as the downloads archive covered in the second article linked above. They are not intended to display like typical WordPress posts, but instead like the products that they are.

That said, you have the ability to take control of the download category and tag templates by creating certain files in the root of your active theme.

taxonomy-download_category.php – taxonomy-download_tag.php

Based on the template hierarchy mentioned above, controlling EDD’s category and tag display would fall under the #2 position. In the WordPress system, a Download category is
download_category and a Download tag is download_tag.

So
taxonomy-{taxonomy}.php is the template naming scheme that WordPress would use to search for template specific to EDD’s Downloads.

If you place files called
taxonomy-download_category.php and taxonomy-download_tag.php in the root of your active theme, WordPress will use those to render your Download categories and tags. What you build into these files is up to you.

If you are a theme developer, you should be familiar with how to build the various template files. You can use our
sample product grid to jumpstart the development of your download category and tag templates. If you are not a theme developer, this is something you would need to hire someone for. How to develop these taxonomy archives is less about EDD and more about WordPress and general development. That is outside the scope of this documentation.

If you are not a theme developer but you are hands-on, there are several theme examples you can use to grasp the concept of creating download category and tag archives for your theme. The best reference would be our
Vendd theme, which you can also find on GitHub for easy access to the codebase.

The post Download Category and Tag Templates first appeared on Easy Digital Downloads.

What happens if a license is not renewed?

1. Automatic security and feature updates will be discontinued.
2. The download link in your EDD site profile will disappear.
3. You will no longer have access to technical support for the item.
4. Some functionality available to paying users will be disabled.

If I renew my license, do I need to also re-download the software and install it again?

No, the built-in automatic update system will take care of all of that for you.

If I upgrade my license today, will it automatically be extended for another year?

No, a license upgrade will not automatically extend the validity of the license key.

Example: You have a license that is due to be renewed automatically on December 1 2023. On November 1 you decide to upgrade your license to a higher one. Your next renewal date after the upgrade will still be December 1, 2023, and it will renew at the price of the package you upgraded to.

Will my extension work with an inactive or expired license?

The Pro version of EDD, Stripe Pro Gateway, and other extensions will continue to work past your license expiration or if it is not activated, however some features that are granted with your Pro license key may be disabled once your license has passed its renewal grace period.

Please note that due to the nature of software updates (such as WordPress and other plugins), there is the possibility that the extension will eventually stop working due to other updates within WordPress or related plugins. For this reason, it is highly recommended that you renew your license, but it is optional.

Can licenses be renewed early or late?

Yes.  Renewing early will extend your license from its previous end (giving you two full years).  Renewing late will give you one more year beginning from your point of renewal.

Early renewal example: If you purchased in April 2014, and renewed in January 2015 your license would expire in April 2016, giving you two full years.

Late renewal example: If you purchased in April 2014, and renewed in July 2015 your license would expire in July 2016, giving you two full years with a gap between April and July 2015.

Are there lifetime licensing options?

No. We do not offer lifetime licenses.

If I have Live and Testing servers, do I need to activate my license on both sites?

Yes, you can activate your licenses on your test server, to receive updates. This will not affect your activation count, as we do not consider local development sites as live sites. If you run into an issues where your development site uses up one of your site activations, please reach out to us and let us know.

How do I renew my license?

See this guide for renewing your license keys.

Will my license renew itself automatically?

Yes, so long as you have not cancelled the subscription. All purchased licenses create a subscription, that will in-turn renew your license key. If you choose to cancel your subscription so it will not auto-renew, you do risk your license key expiring.

How will I know when the license subscription is renewed?

We send emails in the weeks leading up to your renewal being process, as well as once the license key has been renewed.

What if I don’t want to renew?

You can log into your purchase history panel and end your subscription at any time.  This will NOT remove any support time you’ve already paid for, it will merely make it so you don’t automatically renew when your subscription time ends.

The post License Renewal first appeared on Easy Digital Downloads.

In this article, we will cover the basics of how to create single product templates for your theme. To be clear, a single product template is used to display the front-end page created when you add a new Download to your site.

WordPress Template Hierarchy

First, we have to take a step back and examine how WordPress itself works. WordPress themes are nothing more than a collection of files that work together to display your site. Some of those theme files are templates and template components that come together to create the HTML structure of your site.

WordPress uses a
template hierarchy to determined when and how to use those template files. We won’t go into full detail about the entire hierarchy, but here is a visual of how the different template files are related.

What we will cover here is the Single Post template and how it affects the way your single product pages will display. Let’s get started.

Single Post (and Singular) Template

Directly from
wordpress.org, here is the template hierarchy for single posts:

1. single-{post-type}-{slug}.php – (Since 4.4) First, WordPress looks for a template for the specific post. For example, if post type is product and the post slug is dmc-12, WordPress would look for single-product-dmc-12.php.
2. single-{post-type}.php – If the post type is product, WordPress would look for single-product.php.
3. single.php – WordPress then falls back to single.php.
4. singular.php – Then it falls back to singular.php.
5. index.php – Finally, as mentioned above, WordPress ultimately falls back to index.php.

What this means is that a theme file’s name tells WordPress when it should be used and its “rank” in the hierarchy for that particular use case.

The most common file name at this point is most likely
single.php. The single.php template is used to display single blog posts. As you would imagine, many users publish more blog posts on their WordPress sites than anything else. So while single.php is not the highest ranking overall, it
is the highest ranking for generic single post templates.

There is a good chance that your active theme (or parent theme, if you are using a
child theme) has a single.php file in its root folder. If so, it is used to display single blog posts. However, there is also a chance that you do not have a single.php file but instead, a singular.php file. This is becoming more common. Its basic purpose is to be more of a “universal” template for all front-end pages that fall under the WordPress “singular” definition, like blog posts, pages, and entries for basic custom post types.

Let’s cover how EDD uses these templates and how you can change that.

single.php

As mentioned above, the
single.php file is a basic template used to display single blog posts. When the URL of a blog post is visited, WordPress will search the theme structure for the appropriate template file to use for displaying that blog post. The single.php file is the common answer.

With that understanding, you also need to know that Posts (and Pages) are what WordPress calls “post types.” There are a few default post types built into WordPress but developers can also create their own, called Custom Post Types.

EDD itself introduces several custom post types to your system, one of which is the
Download. That’s the only one we are doing to discuss here.

If you scroll back up to take another look at the template hierarchy for single posts, you’ll notice that
single-{post-type}.php has a higher rank than single.php. That implies two things:

1. If single-{post-type}.php fits the scenario, it will be used before single.php.
2. If no single-{post-type}.php template exists, the next choice is single.php.

Unless your theme was written specifically for EDD, your situation falls under the second scenario by default. Given that EDD’s Download custom post type is registered as download, unless your theme includes a
single-download.php file (or the #1 position in the single post hierarchy, which we will not discuss), WordPress will look for the single.php file.

What this means is however your blog posts display, your EDD download will look the same. If your blog posts include byline information, post-to-post navigation, or anything else, it will also display for your downloads.

For many users, this is not a problem. For others, it can add unwanted information to the product display. Or perhaps some users simply do not want their product pages to display in the same fashion as blog posts, which is understandable.

single-download.php

In order to tell WordPress that you’d like to display your single product pages different from your single blog posts, you have to tap into the single post template hierarchy by creating a
single-download.php file in the root folder of your active theme (which would mean your child theme if you are using one).

Once this file is in place in the root folder of your active theme, viewing the front-end page for one of your products will call to the download-specific template instead of the blog post template. At that point, you are in control of your
single-download.php template and you can build it however you’d like.

Here’s a very useful tip for creating your
single-download.php template:

Unless you are a theme developer who already knows what you are doing, the best way to create your initial
single-download.php file is to duplicate your theme’s single.php file and then rename the duplicate to single-download.php. At that point, nothing will change about the display of your product pages. However, you are now free to edit the new template file and it will only affect your product pages.

If you are using a child theme, that means you would need to copy the parent theme’s single post template to put into the root folder of your child theme.

singular.php

Things get a little more complicated here. The
singular.php file is fairly new and while it is not as widely used as the single.php file, it is still popular. As mentioned before, WordPress comes with several post types already built-in and supports the creation of custom post types. All of these post types are considered singulars.

What this means is a theme does
not have to include a single.php file, or even a page.php file (the template used for displaying WordPress Pages). If a singular.php file is present and none of the more specific templates are available, WordPress will use it for all of the post types.

Needless to say, that means this template file oftentimes has to use conditional logic. That means:

If the URL visited is a page, use this code to display the page. If the URL visited is a post, use that code to display the post.

This all happens inside of one template file. For sites with only posts and pages, this is simple. When you introduce custom post types, this can get tricky as the theme developer most likely did not create a condition for the Download custom post type, that is if the theme was not written to consider EDD.

While this is not the place to get into the details of how to build a theme, the same is true in this scenario as with overriding the
single.php for product templates. You can use the singular.php file to create (through duplication) a single-download.php file. The only difference here is that you will need to better understand the code in this file to modify it for use with products.

Single Product Templates In Summation

This is not intended to be a guide on WordPress theming. Instead, the goal is to show you how EDD works with WordPress so that you can use single product templates to display your product pages.

If you are not a WordPress theme developer, this is something you may want to outsource to someone experienced in the area. Creating the necessary file is just one step. Creating (or editing) the code in the file is a completely separate task that requires a bit of experience or at least familiarity with HTML and PHP.

The post How to Build Single Product Templates first appeared on Easy Digital Downloads.

If your PayPal payments are not being automatically marked as Complete, it usually means that one of several common issues is occurring.

In order for a payment to be marked as complete, Easy Digital Downloads has to be able to communicate with the payment processor, such as PayPal, to verify the purchase. If this communication is blocked or tampered with in any way, it can result in the purchases not getting marked as complete, which will also result in download links and purchase receipt emails not getting delivered.

There are several common reasons payments remain as “Pending”:

• PayPal’s Webhooks system is not enabled or configured properly in your PayPal account
• You have a plugin installed that is blocking the requests
• Your website cannot make remote requests through cURL
• You have rules in your .htaccess file that block the IPN requests
• Your site has too aggressive caching that results in improper update queries
• You need HTTPS (SSL) if you are using PayPal

Configuring PayPal

For orders to work properly, your PayPal account needs to be connected. Without it configured payments will not get set to Complete. Confirm PayPal is configured per the documentation.

Prior to EDD 2.11, for orders to work properly, IPN needs to be configured for PayPal Standard and PayPal Express gateways. Without it configured payments will not get set to Complete. Configuring IPN is slightly different for PayPal Standard and PayPal Express, see the guide for the version you are using:

PayPal (Legacy)

Stripe

If this happens with Stripe, it’s an indication that something is interfering with the checkout process and preventing EDD from getting responses from Stripe. If this is happening for all purchases, deactivate all other plugins except EDD and see if the issue continues. If not, re-activate each plugin one at a time until the problem comes back. Reach out to EDD support if you need assistance investigating this issue.

CloudFlare

CloudFlare is a popular service that helps improve the performance and security of your website. Occasionally it can cause conflicts with the purchase verification process.

If you are experiencing problems with your payments not being marked as complete and you use CloudFlare on your website, try disabling CloudFlare temporarily to see if payments are properly marked as complete when it is disabled.

You may need to exclude your checkout page from Cloudflare’s caching. Here is one of their help articles to get you started with that:
https://support.cloudflare.com/hc/en-us/articles/200172316-How-do-I-exclude-a-specific-URL-from-CloudFlare-s-caching-

Remote requests fail: cURL Disabled

If your web host has cURL and/or other remote communication extensions disabled, it can cause trouble with Easy Digital Download’s ability to communicate with PayPal.

You can confirm whether this is the potential cause by going to Downloads > System Info and looking for this section:

WP Remote Post: wp_remote_post() works

If it says that wp_remote_post() does not work, please contact your web host and ask them to enable cURL.

You can further confirm whether this is the problem by going to Downloads > Reports > Logs > Payment Errors and looking to see if there are any error messages recorded that look like this:

{"errors":{"http_failure":["There are no HTTP transports available which can complete the requested request."]},"error_data":[]}

That error means your site cannot communicate with PayPal, so payments cannot be verified.

Conflicting Plugins

If the PayPal IPN is fully functional, to the best of your knowledge, and the problem still persists, it is very likely that you have another plugin, such as  Bad Behavior, installed that is blocking the PayPal IPN. These kind of anti-spam plugins typically block PayPal communication. If you do have one of these plugins installed, try deactivating it, do a test purchase, and then see if your payment is marked as complete.

Plugins that have been known to cause issues:

• All-In-One Security
• Bad Behavior
• Complete Cache
• iThemes Security
• Wordfence Security
• W3 Total Cache
• WP Super Cache
• WP-SpamShield

If you have one of these plugins activated, try deactivating it and then perform a test purchase. If payments are marked as complete once the plugin is deactivated, you will know what the cause is.

Just because you have one of these plugins installed does not, however, mean that you are guaranteed to experience problems. All of these plugins can be configured successfully to work just fine alongside Easy Digital Downloads. Usually, the problem is a result of one or two particular configuration options within the plugin.

Server Blocking

Occasionally a server setting can block the IPN response.  Here are some known issues,

Strato

Strato is a German host and has a guestbook security setting that interferes with PayPal. Here’s how to turn that setting off:

1. Log in to Strato Customer Service.
2. Choose hosting package change.
3. Select the Settings item.
4. Select Point Server Side Security.
5. Disable the item ‘filter for guestbook spam’.

Cross Domain HTTP Requests

If you have a plugin that forces HTTP traffic to HTTPS and the IPN request comes in on HTTP it’ll be rejected since those are technically different domains. If you’re finding your IPN requests being rejected, make sure you’re running the same protocol on all requests.

The post PayPal payments not marked as Complete first appeared on Easy Digital Downloads.

Pending

This is a payment that has begun, but is not complete.  An example of this is someone who has filled out the checkout form and then gone to PayPal for payment.  We have the record of sale, but they haven’t completed their payment yet.

Complete

This is a payment that has been paid and the product delivered to the customer.

Refunded

This is a payment where money has been transferred back to the customer and the customer no longer has access to the product.

Failed

This is a payment where the payment process failed, whether it be a credit card rejection or some other error.

Abandoned

If a Pending payment is never completed it becomes Abandoned after a week.

Revoked

Revoked payments restrict access to the product without refunding money.

Preapproved

A preapproved payment is one where the customer has approved the payment, but it hasn’t been processed yet.  It’ll be processed at a later date.

On Hold

An Order’s status will update to On Hold if the customer disputes a payment. The On Hold status will disable the license and prevent downloads while the dispute process takes place. The dispute reason will be shown below the order status. If a dispute is accepted or lost, the store admin will need to initialize a refund. In the event the dispute is reversed, a store admin can set the order status back to Completed.

Cancelled

Cancelled is used in two different scenarios. One deals with  Recurring Payments. When a subscription is cancelled then the original payment gets set to cancelled as well.

Cancelled is also used with preapprovals. A preapproval may be cancelled before payment is made.

Note: This payment status is no longer used. It was formerly required by Recurring Payments but now exists only for backwards compatibility.

Subscription

This refers to a renewal payment for a subscription that uses recurring billing. This payment status will be present if Recurring Payments is active.

Other

This list is not comprehensive as some extensions to Easy Digital Downloads introduce additional statuses. If you see an available payment status which is not on this please, please consult the documentation for the extensions you are currently using.

The post What do the different payment statuses mean? first appeared on Easy Digital Downloads.

If you are seeing the error “Sorry, this file could not be downloaded.” when attempting to download files, please read the following.

Notice: As of Easy Digital Downloads 2.9.13, any files delivered by absolute path, are required to live within the WP_CONTENT_DIR directory or a subdirectory of the WP_CONTENT_DIR. By default this location is the wp-content directory. The above error indicates that you are using absolute file paths for files that are stored in an unsupported directory. Moving these files and/or folders to the wp-content directory will resolve this issue.

One easy method is to store your files someplace other than your server. The Amazon S3 and Dropbox addons both allow for this, and integrate seamlessly into the WordPress Media Library. Once they’re installed you use the Media Library like normal, but the files are stored elsewhere, and the file size issue is resolved.

If however you’d like to keep your files local, there is a way to accomplish that. We recommend using a plugin called Add From Server.

Quick Description

1. You use an SFTP program or any other upload method that works to place the file on your server in the right folder
2. You browse to that folder in Add From Server
3. You use Add From Server to import the file to the media library

After that, everything is the same.

Detailed Description

Settings

First install Add From Server the normal way in your WordPress plugins interface. Once it’s installed you can go to Settings → Add From Server and see where you can set up access control.

For user access control we recommend you leave the default of “All users with the ability to upload files”. This means everyone who can already upload can use this tool.Next, you may choose to lock browsing to a specific directory. This is not recommended for use with Easy Digital Downloads. You’ll want the flexibility to put your downloads in a variety of places as needed.

Uploading Your Files

Next you’ll want to upload your files via a means other than WordPress. This can be done via SFTP, an uploader tool in your hosts panel, or whatever way works for you.

IMPORTANT: You must place the files in the proper place on your site.

WordPress normally uploads things to
/wp-content/uploads/YEAR/MONTH/ where YEAR and MONTH are actual numerical values like /2015/08/.

Easy Digital Downloads keeps files in in
/wp-content/uploads/edd/YEAR/MONTH/. This allows for file locking, and the prevention of theft.

You want to upload your file to the current month’s folder. You may create it if it doesn’t exist.

Adding From Server

In the WordPress admin menu, under Media, choose Add From Server and you’ll see something like the image below:

You want to click Content Folder, then uploads, and then edd. Continue drilling down until you find your file.

There’ll be a checkbox next to your file. Check that and click the Import button. There’s an option for File Time or Current Time and it doesn’t matter which you choose.

After you click the Import button then your file is officially in the WordPress Media Library.

You may now go to Add a new Download, and when it asks you to Upload your file, simply go to the Media Library and choose it.

The post How can I use files that are too large for WordPress to upload? first appeared on Easy Digital Downloads.

• Caching Plugins
• Cloudflare
• Web Host Caching
• Varnish
• Server does not support PHP Sessions
• Blocked admin-ajax.php File
• Blocked /wp-admin/
• Browser cookies disabled
• URL Settings
• .htaccess rules
• Known Plugin Conflicts

Easy Digital Downloads has a native shopping cart system that allows store visitors to add multiple items to their shopping carts before checking out. However, there are a number of host, site, and browser configurations that can break this functionality and cause the cart to appear empty at checkout.

On rare occasions, due to a server configuration, hosting settings, or conflict with other plugins, you may experience your shopping cart being empty after adding an item to your cart. In this article we’ll explain some of the reasons this can happen, and what you can do to resolve the issue.

Caching Plugins

Caching plugins are a very common culprit because they are so widely used. Their purpose is simple – caching plugins speed up load times for your website by storing certain website data for easy access when requested by the browser. While this is a great way to make your site fast and reduce server traffic, some slight changes may be necessary in order to get your shopping cart working correctly.

Disable caching on your Checkout Page

Because the information on your checkout page is specific to a single visitor, it should never be cached as it could produce undesired results for your customers. Adding items to the cart, removing them, calculating cart totals, and all other functions of the checkout page need to reflect the actual state of the page data every time it is loaded. Failing to disable caching on your checkout page can result in a number of issues including customer’s not being able to purchase or having their orders contain incorrect totals, taxes, or products.

If you are using a plugin such as W3 Total Cache, WP Super Cache, or another similar plugin, you must configure it to avoid caching on the checkout page.

If you are using Varnish as a caching layer, you may want to jump to our section about using Varnish with Easy Digital Downloads.

Cloudflare

Cloudflare is a very powerful service for improving your store’s performance and securing your business, and we use on this very site you are on right now. To configure Cloudflare to work with your Easy Digital Downloads powered store, you only need to make a few minimal modifications.

Page Rules

Create the following Page Rules within your Cloudflare settings. Page Rules can be added by clicking Rules → Page Rules → Create Page Rule.

First, from your Cloudflare Site Dashboard find the ‘Rules’ menu on the left, expand it and click on ‘Page Rules’.

This is where you can manage your different page rules and arrange them in order of precedence. It is best to keep your checkout page rule at the top of this list, so that it is the first one to be processed and no other rules will affect your checkout.

To create a Page Rule, click on the ‘Create Page Rule’ button

When creating a Page Rule, you need to define what URLs this rule applies to and what rules you want Cloudflare to apply. For Checkout pages, we want to always bypass Cloudflare’s caching layer so we’ll use the ‘Cache Level’ setting and set it to ‘Bypass’. This means that Cloudflare will send any request for the Checkout page to your server directly.

When adding this Page Rule, ensure that you end the URL with the trailing slash and * character. This will ensure that it matches any query string parameters like discount codes and other features of EDD’s checkout will not be impacted.

Web Host Caching

Though less common, server-side caching can be just as big of a problem for your shopping cart system. Many web hosts offer caching services that you opt into and configure yourself. Others, such as
WP Engine, practice aggressive caching that is pre-configured for you. While these tools can help your store perform better and convert more users, we may need to make some adjustments for a balance of performance and reliability.

WP Engine

If you host your site on  [thirstylink ids=”1724167″ href=”https://easydigitaldownloads.com/refer/wpengine/”]WP Engine[/thirstylink], you may encounter some issues with empty carts when visiting the checkout page. This is due to aggressive page caching (which is a good thing!), but it can be easily resolved by requesting that WP Engine setup a special cache exception for your checkout page.

To do this, simply submit a support ticket to WP Engine via their support portal and ask them to exclude your checkout page from cache.

Your checkout page is the one that has the [download_checkout] short code on it, and is saved in Downloads > Settings:

To make things really easy for you, feel free to copy and paste this sample ticket:

Hi!

My site runs the Easy Digital Downloads e-commerce plugin and we are having some issues with page caching and the checkout page. The Easy Digital Downloads team has instructed us to ask you to place a cache exception on our checkout page.

Could you please add the following URL to the exception list?

http://YOURSITE.com/{put your checkout page URL here}

Thanks!

Note: While the checkout page may no longer be cached, you may still have a problem with the “Remove” link in your cart not properly removing items from the cart. If this occurs, ask WP Engine to “exclude the ‘edd_saved_cart’ and ‘edd_items_in_cart’ cookies from cache” and that should fix the link.

EasyEngine/Nginx

If you are hosting your site with EasyEngine/Nginx and happen to be using Redis caching, you will have to find and edit your redis.conf (or redis-php7.conf) and add edd_items_in_cart|. So, for example, your exceptions could look something like this:

# Don't use the cache for logged in users or recent commenter
if ($http_cookie ~* "edd_items_in_cart|comment_author|wordpress_[a-f0-9]+|wp-postpass|wordpress_no_cache|wordpress_logged_in") { set $skip_cache 1; }

Varnish

If you are experiencing empty shopping carts when using a Varnish caching server with your Easy Digital Downloads store, you might try and use the following rules to help prevent this:

In your Varnish Configuration

// Tells Varnish to pass through on the checkout page
if (req.url ~ "checkout") { return (pass); }

// Tells Varnish to pass through on any request with edd_action in the query string
if (req.url ~ "edd_action") { return (pass); }

// Tells Varnish to pass through on any request with add_to_cart in the query string
if (req.url ~ "add_to_cart") { return (pass); }

// Tells Varnish to pass through if any cookies with `edd` are found
if (req.http.cookie ~ "(^|;s*)edd") { return (pass); }

Some Varnish tutorials and configurations suggest re-ordering query string arguments to optimize cache hit rates. This feature of Varnish can result in file download links generated by Easy Digital Downloads to fail, due to the secure link verification it uses. If you want to use this caching technique, we’ve written a helpful guide on how to support query string modification with Easy Digital Downloads, and still give customers access to secure file downloads.

Server does not support PHP Sessions

PHP sessions are designed to give your site visitors a more customized experience. The ability to add items to a shopping cart from page to the next, and then see all of store items in the cart at checkout is about as personal as it gets for a brand new visitor that hasn’t shared any information with your site.

Some servers or hosts do not support using PHP’s native ‘session handler’. Easy Digital Downloads stores your visitor’s cart information in their PHP session, however, when this feature of PHP is not available, it can produce empty carts as the cart data cannot be saved between page views.

Easy Digital Downloads supports storing session data in the database and using cookies help mitigate this issue. Using this version of ‘session’ management is not as fast as using PHP sessions as it relies on the database, however it can resolve the empty cart issue.

To enable Database Sessions, go to Downloads > Settings > Misc > General and set Session Handling to Database Sessions.

To attempt to keep your database performing in an optimal way, Easy Digital Downloads does clean up abandoned sessions twice a day, using WordPress’s WP Cron events.

Blocked admin-ajax.php File

Included in WordPress core is a file called admin-ajax.php which is used heavily throughout WordPress, including Easy Digital Downloads. Blocking access to this file can cause issues with your cart behavior and other aspects of your WordPress site. It is never suggested to block access to this file.

If you are using any security plugins or have aggressive security settings on your server, temporarily disable them and check the cart functionality again. If your security settings block this file, your cart will not work properly.

For more information on blocked admin-ajax.php, see the full documentation.

Blocked /wp-admin/

There are plugins that block access to /wp-admin/ for security purposes, and these sometimes also block access to the previously mentioned admin-ajax.php file, causing the problems listed above.

To test to see if this is the issue, temporarily deactivate admin blocking plugins. If the problem is resolved then you know it was that plugin.

Browser cookies disabled

EDD uses cookies to store information with sessions and keep count of the items in your cart. If your browser cookies are disabled, the shopping cart system may not work as expected.

URL Settings

As mentioned previously, Easy Digital Downloads uses Sessions and Cookies to be able to save a visitors cart data between page visits, so they can have a unique experience on your store. Cookies are pieces of information about the user that are stored in their browser. For security reasons, the cookies that Easy Digital Downloads uses define the store’s URL in their creation. It is important that your WordPress site is configured to maintain the same URL between the page where you add an item to your cart and your checkout page.

This includes the http or https portion of the URL. If you attempt to add a product to the cart on a page that is using http and your checkout page is secured with an SSL, displaying with https, your cart will be empty as the secure checkout page does not have access to the cookie added by the unsecured page you previously used to add the item to the cart.

We suggest that your entire store is loaded in a secure form with https in the URL, including your WordPress URL settings. If your host does not provide you with an SSL certificate for your store, [thirstylink ids=”1724133″ href=”https://easydigitaldownloads.com/refer/godaddy-ssl/”]you can obtain one[/thirstylink] and have your host install it. Ensure your host can configure your site to only load over https, but if they cannot, you can always use [thirstylink ids=”1723021″ href=”https://easydigitaldownloads.com/refer/really-simple-ssl/”]Really Simple SSL[/thirstylink] to force WordPress to load your site with the SSL Secured version every time.

Make sure that whatever you have set under Settings → General is used in all links throughout your site.

In some cases, we have seen where a 3rd party plugin or script installed modifies the Site Address or WordPress address automatically after a certain amount of time. Double check that your Site Address is not being modified in order to keep your store working as expected.

.htaccess rules

The .htaccess file is used by the server to properly route user requests to your pages. WordPress has a set of default rules that we rely on in order for the cart to properly work. If you are having problems with your cart being empty, try and use the default .htaccess configuration set by WordPress.

Known Plugin Conflicts

Although rare, there can be some conflicts between the Easy Digital Downloads shopping cart and other WordPress plugins. While we attempt to work around these with our code, sometimes we cannot and as such we maintain a list of plugins that we cannot guarantee will work well with Easy Digital Downloads. If you run into a known plugin conflict, please reach out to our support team with as much detailed information you can about the conflict and we’ll be happy to look into the issue for you.

The post Shopping Cart Is Empty at Checkout first appeared on Easy Digital Downloads.

YOU ACCEPT AND AGREE TO THIS AGREEMENT AND CONSENT TO EASYDIGITALDOWNLOADS’S PRIVACY POLICY LOCATED AT https://easydigitaldownloads.com/privacy-policy/ (THE “PRIVACY POLICY”), BY DOING ANY ONE OF THE FOLLOWING ITEMS: (1) VISITING THIS SITE; (2) MAKING A PURCHASE OR SUBMITTING CONTENT THROUGH THE SITE; (3) COMPLETING THE ONLINE APPLICATION PROCESS BY CLICKING A BOX INDICATING YOUR ACCEPTANCE; OR (4) BY EXECUTING A SUBSCRIPTION THAT REFERENCES THIS AGREEMENT. If you are entering into this Agreement on behalf of a company or other legal entity, you represent that you have the authority to bind such entity to these terms and conditions, in which case the terms “you” or “your” shall refer to such entity. If you do not have such authority, or if you do not agree with these terms and conditions, you must not accept this Agreement and may not use the services. The provisions of this Agreement that relate to terms for the payment of fees specified in any subscription to Services apply only to the Personal, Extended, Professional, and All Access Pass paid subscriptions, and any subscription for individual licenses. All other terms apply.

On our Site, we may provide short summaries of the terms and conditions in this Agreement. Any such summaries are provided only for your convenience, are not legally binding and do not modify this Agreement in any way.

Sandhills Development may update or modify this Agreement or the Privacy Policy at any time and such updated versions will be posted on the Site. You are responsible for periodically checking the Agreement and Privacy Policy. Your continued use of the Site and/or the Services after this Agreement and/or Privacy Policy are updated shall be deemed acceptance of any such updated Agreement and/or Privacy Policy.

Ability to Enter into this Agreement

This Site and the Services are not designed for or directed at children 13 years of age or younger. In addition, in order to enter into this Agreement, you must be 18 years old or have otherwise reached the legal age of majority in your jurisdiction of residence or possess legal parental or guardian consent, and are fully able and competent to enter into the terms, conditions, obligations, affirmations, representations and warranties set forth in this Agreement, and to abide by and comply with this Agreement. It is your responsibility to ensure that you are legally eligible to enter into this Agreement under any laws applicable to you in your jurisdiction of residence or otherwise. If you accept this Agreement, you represent that you have the capacity to be bound by it.

You may not use the Services and may not accept this Agreement if (a) you are not of legal age to form a binding contract with Sandhills Development, or (b) you are a person barred from receiving the Services under the laws of the United States or other countries including the country in which you are a resident or from which you use the Services.

Before you continue, you should print or save a local copy of this Agreement for your records.

Your Profile Information and Account

In order to access certain Services, you may be required to provide information about yourself (such as API, identification or contact details) as part of the registration process for the Service or as part of your continued use of the Services. You may also have to create passwords or other forms of authentication. You agree to provide true, accurate, current and complete information about yourself, and you may not misrepresent your profile information. You agree and understand that you are responsible for maintaining the confidentiality of any such information or passwords. Accordingly, you agree that you will be solely responsible to Sandhills Development for all activities that occur under your account. If you become aware of any unauthorized use of your password or of your account, you agree to notify Sandhills Development immediately.

Your right to access and use the Services is personal to you and is not transferable by you to any other person or entity. You agree not to disclose your password to any third party. You are solely responsible for all activities that occur under your Account or under your Profile Information. If you become aware of any unauthorized use of your Account or Profile Information, you are responsible for notifying Sandhills Development immediately.

By providing us with your e-mail address, you agree to receive all required notices electronically to that e-mail address. It is your responsibility to update or change that e-mail address, as appropriate.

By providing us with your phone number, you agree to allow Sandhills Development to contact you via that telephone number regarding all billing notices and/or inquiries (including, but not limited to: payment issues, billing discrepancies, declined/failed payments and/or expired payment methods). It is your responsibility to update or change that phone number, as appropriate.

Fees

You shall pay all fees specified in any subscription to Services or use of the Site (“Subscription”). We will charge you a periodic fee based on the Subscription you choose. Such fees shall be billed in advance for each period and are non-refundable except as specifically mentioned in these Terms of Service. Except for refunds provided for cancellation of Subscriptions within the first fourteen (14) days (as described in the section below entitled Cancellation and Termination and in the Sandhills Development Refund Policy), there will be no refunds or credits for partial months of service or for periods in which your Subscription remains active but you do not use the Services

We reserve the right to modify our billing rates at any time upon thirty (30) days written notice by posting such fee changes to the Services or on the Site.

At our discretion, we may offer free or discounted pricing for use of the Services (a “Trial Program”). Once the terms of any Trial Program have expired, you agree that our normal billing rates shall apply. You agree to comply with any additional terms, restrictions or limitations (including limitations on the total amount of usage) we impose in connection with any Trial Program. You may not sign-up for multiple Accounts in order to receive additional benefits under any Trial Programs.

You agree to pay all charges incurred by users of your credit card, debit card, or other payment method used in connection with your Subscription at the prices in effect when such charges are incurred. You will pay any applicable taxes, if any, relating to any such purchases, transactions or other monetary transaction interactions.

All prices listed, fees, charges and refunds are issued in USD. We make no guarantees as to the exchange rate between any currencies, or that the exchange rate will remain unchanged during any period of time. The cost of Services may increase or decrease over a given period of time depending on the currency you choose to pay with and the specific exchange rate at that time. Refunds are likewise issued in USD and are subject to exchange rate volatility. There will be no additional refunds or credits issued in consideration of current or eventual exchange rates. You are responsible for any currency exchange taxes, fees, or other costs that may incur by making a purchase of our Services.

Intellectual Property Rights

All right, title, interest and ownership and intellectual property rights in and to the Site, Easy Digital Downloads trademarks and the templates provided via the Site, including but not limited to its “look and feel” (e.g., text, graphics, images, logos, buttons, icons and the placement and layout thereof), images, video, audio, data, content, software (including html-based computer programs) and other media, material or information, other than your Content, are and will remain the property of Sandhills Development or its software or content suppliers. Any templates or derivatives of templates provided that you may build using the Site belong to Sandhills Development. The Site is protected under Canada, United States and international copyright, trademark and other laws and treaties.

Subject to the terms and conditions of this Agreement, Sandhills Development grants to you, during the term of this Agreement, a non-transferable, non-sublicensable, non-exclusive, revocable, limited-purpose right to access and use the Services that are subject to a valid Subscription.

You acknowledge that any ideas, suggestions, concepts, processes or techniques which you provide to Sandhills Development related to the Services, the Site or Sandhills Development or its business (“Feedback”) shall become Sandhills Development’s property without any compensation or other consideration payable to you by Sandhills Development, and you do so of your own free will and volition. Sandhills Development may or may not, in its sole discretion, use or incorporate the Feedback in whatever form or derivative Sandhills Development may decide into the Site, its software, services, documentation, business or other products, or any future versions or derivatives of the foregoing. You hereby assign all rights on a worldwide basis in perpetuity to Sandhills Development in any Feedback and, as applicable, waive any moral rights.

Sandhills Development owns any test results, data information and other output generated by your use of the Site and/or the Services during the term of this Agreement.

The following are registered trademarks, trademarks or service marks of Sandhills Development, LLC or its Affiliates: EASYDIGITALDOWNLOADS. All custom graphics, icons, logos and service names are registered trademarks, trademarks or service marks of Sandhills Development, LLC or its Affiliates. All other trademarks or service marks are property of their respective owners. Nothing in these Terms of Use grants you any right to use any trademark, service mark, logo, and/or the name of Sandhills Development, LLC or its Affiliates.

Confidential Information

You agree to safeguard, keep secret and not to disclose to any third party, any Confidential Information acquired, learned or provided from Sandhills Development during the term of this Agreement or following the expiration or termination of this Agreement. “Confidential Information” means any information marked confidential or that ought reasonably to be considered confidential under the circumstances and includes, without limitation, any business plans, customer lists, operation procedures, trade secrets, design formulas and programming code, know-how and processes, computer programs and inventions, discoveries, and improvements of any kinds.

Plugin License

Easy Digital Downloads WordPress plugin is licensed under the GNU general public license (https://www.gnu.org/licenses/gpl.html) version 2.0 or later.

Disclaimer of Warranties

YOUR USE OF THE SITE AND ALL CONTENT FORMING PART OF OR RELATED TO THE SITE, INCLUDING ANY CONTENT YOU UPLOAD OR SUBMIT AND ANY THIRD PARTY SOFTWARE AND CONTENT, ARE AT YOUR SOLE RESPONSIBILITY AND RISK. THE SITE IS PROVIDED ON AN “AS IS” AND “AS AVAILABLE” BASIS. EASY DIGITAL DOWNLOADS EXPRESSLY DISCLAIMS ALL REPRESENTATIONS, WARRANTIES, OR CONDITIONS OF ANY KIND WITH RESPECT TO THE SITE, WHETHER EXPRESS OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OR CONDITIONS OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE, ACCURACY, COMPLETENESS, PERFORMANCE, SYSTEM INTEGRATION, QUIET ENJOYMENT, TITLE, AND NON-INFRINGEMENT.

EASY DIGITAL DOWNLOADS DISCLAIMS ANY WARRANTY THAT THE SITE OR ANY CONTENT, INCLUDING WITHOUT LIMITATION ANY THIRD PARTY SOFTWARE AND CONTENT, WILL MEET YOUR REQUIREMENTS OR BE UNINTERRUPTED, TIMELY, SECURE, OR ERROR-FREE, THAT DEFECTS WILL BE CORRECTED, OR THAT THE SITE OR THE SERVERS THAT MAKES THE SITE AVAILABLE ARE FREE OF VIRUSES OR OTHER HARMFUL COMPONENTS. YOU AGREE THAT, FROM TIME TO TIME, EASY DIGITAL DOWNLOADS MAY REMOVE THE SITE FOR INDEFINITE PERIODS OF TIME WITHOUT NOTICE TO YOU. YOUR ACCESS AND USE OF THE SITE MAY BE INTERRUPTED FROM TIME TO TIME FOR ANY OF SEVERAL REASONS, INCLUDING, WITHOUT LIMITATION, THE MALFUNCTION OF EQUIPMENT, PERIODIC UPDATING, MAINTENANCE OR REPAIR OF THE SITE OR OTHER ACTIONS THAT EASY DIGITAL DOWNLOADS, IN ITS SOLE DISCRETION, MAY ELECT TO TAKE. EASY DIGITAL DOWNLOADS MAKES NO GUARANTEE REGARDING: (A) THE SECURITY OF ANY INFORMATION PROVIDED BY YOU INCLUDING BUT NOT LIMITED TO YOUR API; OR (B) THE COMPATIBILITY OF YOUR SOFTWARE, HARDWARE OR CONTENT WITH THE SITE.

EASY DIGITAL DOWNLOADS IS NOT RESPONSIBLE FOR THE ACTS OR OMISSIONS OF, OR FOR THE FAILINGS OF, ANY THIRD-PARTY PROVIDER OF ANY CONTENT, SERVICE, NETWORK, SOFTWARE OR HARDWARE, INCLUDING BUT NOT LIMITED TO, INTERNET SERVICE PROVIDERS, HOSTING SERVICES UTILIZED BY EASY DIGITAL DOWNLOADS, TELECOMMUNICATIONS PROVIDERS, CONTENT PROVIDED BY OTHER USERS, OR ANY SOFTWARE OR HARDWARE NOT PROVIDED BY EASY DIGITAL DOWNLOADS.

YOU ARE SOLELY RESPONSIBLE FOR ENSURING THAT YOUR CONTENT IS COMPATIBLE WITH THE SITE. EASY DIGITAL DOWNLOADS DISCLAIMS ANY LIABILITY OR RESPONSIBILITY FOR ANY UNAUTHORIZED USE OF YOUR CONTENT BY THIRD PARTIES OR OTHER USERS OF THE SITE AND IS NOT RESPONSIBLE FOR PROTECTING YOUR CONTENT.

ANY MATERIAL DOWNLOADED OR OTHERWISE OBTAINED THROUGH THE USE OF THE SITE IS DONE AT YOUR OWN DISCRETION AND RISK AND YOU WILL BE SOLELY RESPONSIBLE FOR ANY DAMAGE TO YOUR COMPUTER SYSTEM OR OTHER DEVICE OR LOSS OF DATA THAT RESULTS FROM THE DOWNLOAD OF ANY SUCH MATERIAL.

NO ADVICE OR INFORMATION, WHETHER ORAL OR WRITTEN, OBTAINED BY YOU FROM EASY DIGITAL DOWNLOADS OR THROUGH OR FROM THE SITE SHALL CREATE ANY WARRANTY NOT EXPRESSLY STATED IN THIS AGREEMENT.

THE SITE IS OFFERED AND CONTROLLED BY EASY DIGITAL DOWNLOADS FROM ITS FACILITIES IN THE UNITED STATES. EASY DIGITAL DOWNLOADS MAKES NO REPRESENTATIONS THAT THE SITE IS APPROPRIATE OR AVAILABLE FOR USE IN OTHER LOCATIONS. THOSE WHO ACCESS OR USE THE SITE FROM OTHER JURISDICTIONS DO SO AT THEIR OWN VOLITION AND ARE RESPONSIBLE FOR COMPLIANCE WITH LOCAL LAW.

Web Content Accessibility Guidelines Compliance Disclaimer (“WCAG Disclaimer”)

YOU ACKNOWLEDGE AND AGREE THAT EASY DIGITAL DOWNLOADS DO NOT WARRANTY, ASSURE AND/OR GUARANTEE THAT ITS SOFTWARE IS OR SHALL EVER BE COMPLIANT WITH THE WEB CONTENT ACCESSIBILITY GUIDELINES PURSUANT TO WCAG 2.0, WCAG 2.1, AND/OR ANY SUCCESSOR LAWS OR GUIDELINES (COLLECTIVELY, “WCAG COMPLIANCE”).

YOU FURTHER ACKNOWLEDGE AND AGREE THAT EASY DIGITAL DOWNLOADS DOES NOT WARRANTY, ASSURE AND/OR GUARANTEE THAT ITS SOFTWARE, CODING, AND/OR PHP PROGRAMMING LANGUAGE CAN BE MODIFIED TO MEET WCAG COMPLIANCE.

BY USING AND/OR DOWNLOADING EASY DIGITAL DOWNLOADS YOU EXPRESSLY ACCEPT EASY DIGITAL DOWNLOADS AS-IS AND AGREE TO BE FULLY RESPONSIBLE AND SOLELY LIABLE TO ENSURE THAT YOUR WEBSITE AND/OR YOUR INTENDED USE OF EASY DIGITAL DOWNLOADS MEETS WCAG COMPLIANCE AND ANY OTHER ACCESSIBILITY REGULATIONS, AS REQUIRED BY LAW, WHICH MAY CHANGE FROM TIME-TO-TIME. YOU FURTHER AGREE TO TEST EASY DIGITAL DOWNLOADS AND ALL OF ITS FUNCTIONALITY AND FEATURES ON YOUR WEBSITE LOCALLY PRIOR TO ALLOWING EASY DIGITAL DOWNLOADS TO BECOME LIVE TO THE PUBLIC IN ORDER TO ENSURE THAT YOU ARE ABLE TO MEET WCAG COMPLIANCE. FURTHER, IT IS YOUR RESPONSIBILITY TO REMAIN INFORMED ON ALL ISSUES AND REQUIREMENTS RELATING TO WCAG COMPLIANCE.

BY CHOOSING TO DOWNLOAD, INSTALL AND/OR OTHERWISE USE EASY DIGITAL DOWNLOADS ON YOUR WEBSITE, A THIRD-PARTY WEBSITE, AND/OR ANY OTHER ONLINE PLATFORM YOU HEREBY CLAIM THAT ANY SUCH WEBSITE(S) AND/OR ONLINE PLATFORM(S), INCLUDING ALL PAGES AND FEATURES HAVE BEEN TESTED BY YOU AND MEET WCAG COMPLIANCE. IN NO EVENT SHALL EASY DIGITAL DOWNLOADS (INCLUDING ANY OF ITS AUTHORIZED REPRESENTATIVES, PRINCIPALS, AGENTS, OFFICERS, DIRECTORS, SHAREHOLDERS, MEMBERS, PARTNERS, EMPLOYEES, ASSOCIATES, SUCCESSORS, ASSIGNS, SUBSIDIARIES, LICENSEES AND/OR OWNERS) BE LIABLE TO YOU OR TO ANY THIRD-PARTY CLAIMING THROUGH YOU OR ON YOUR BEHALF FOR ANY FAILURE TO MEET WCAG COMPLIANCE. YOU AGREE TO TAKE ALL RESPONSIBILITY RELATED TO MEETING WCAG COMPLIANCE.

IN THE EVENT THERE ARE ANY CONTRADICTIONS BETWEEN THE TERMS CONTAINED IN THIS WCAG DISCLAIMER AND ANY OTHER TERMS OF SERVICE ON THIS SITE, THEN THE TERMS HEREIN SHALL CONTROL AS TO AN INCONSISTENCIES.

Support

Support for plugins sold and distributed by Easy Digital Downloads is only available for those who have an active, paid support license.

Support, updates and plugin downloads are granted for one year after the original purchase based on the license that you have purchased. After one year is completed, the purchaser must renew their license in order to continue receiving support, updates, and access to download plugin files for the items purchased.

Support for Easy Digital Downloads is provided as long as Easy Digital Downloads is actively in development. Should any one of the following occur, Sandhills Development, LLC will no longer be responsible for providing support for Easy Digital Downloads:

1. Easy Digital Downloads is no longer actively developed as a viable product under Sandhills Development, LLC.
2. Easy Digital Downloads or the parent company is purchased or bought out by another company.
3. WordPress is no longer actively developed.

While we attempt to provide the best support possible for our plugins, we do not guarantee that any particular support query can or will be answered to the extent that the inquirer is completely satisfied.

License Holders

Only a license holder is permitted to request support or access support resources. If any attempt is made by another party other than the license holder to access support in a manner not specified, we reserve the right to suspend indefinitely the license key without notice or consent.

Re-posting content from any portion of this site, including support forum and documentation materials, is strictly prohibited. If any attempt is made to re-post content in a manner specified above, we reserve the right to suspend indefinitely the license key without notice or consent.

Sharing or Reselling your license key is not allowed. If we discover a violation of this rule, we reserve the right to immediately suspend the account without notice, indefinitely.

Inactive License

If your license becomes inactive and is otherwise no longer valid, (a) Easy Digital Downloads will no longer be obligated to provide you the Services, (b) your account will no longer be accessible by you to download plugin files, create new forms or edit existing forms, templates or derivatives of templates that you may have built using the Site, (c) you will immediately stop using Services, and (c) all licenses and other rights granted to you under the Agreement will immediately cease. Easy Digital Downloads will not be liable to you or any
third party for termination of this Agreement or any termination or suspension of your use of the Services.

YOU ACKNOWLEDGE THAT YOUR CONTENT MAY BE DELETED FROM YOUR ACCOUNT UPON YOUR LICENSE BECOMING INACTIVE. THIS CONTENT CANNOT BE RECOVERED ONCE DELETED. IF YOUR LICENSE IS NOT ACTIVE, EASY DIGITAL DOWNLOADS WILL NOT STORE CONTENT ON YOUR BEHALF.

Limitation of Liability / Exclusion of Consequential and Related Damages

NEITHER PARTY’S LIABILITY WITH RESPECT TO ANY SINGLE INCIDENT ARISING OUT OF OR RELATED TO THIS AGREEMENT WILL EXCEED THE AMOUNT PAID BY YOU HEREUNDER IN THE 12 MONTHS PRECEDING THE INCIDENT, PROVIDED THAT IN NO EVENT WILL EITHER PARTY’S AGGREGATE LIABILITY ARISING OUT OF OR RELATED TO THIS AGREEMENT EXCEED THE TOTAL AMOUNT PAID BY YOU HEREUNDER. THE ABOVE LIMITATIONS WILL APPLY WHETHER AN ACTION IS IN CONTRACT OR TORT AND REGARDLESS OF THE THEORY OF LIABILITY. HOWEVER, THE ABOVE LIMITATIONS WILL NOT LIMIT YOUR PAYMENT OBLIGATIONS UNDER THE “FEES” SECTION OF THE AGREEMENT.
IN NO EVENT WILL EITHER PARTY HAVE ANY LIABILITY TO THE OTHER PARTY FOR ANY LOST PROFITS, REVENUES OR INDIRECT, SPECIAL, INCIDENTAL, CONSEQUENTIAL, COVER OR PUNITIVE DAMAGES, WHETHER AN ACTION IS IN CONTRACT OR TORT AND REGARDLESS OF THE THEORY OF LIABILITY, EVEN IF A PARTY HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES. THE FOREGOING DISCLAIMER WILL NOT APPLY TO THE EXTENT PROHIBITED BY LAW.

THE FOREGOING LIMITATIONS SHALL ALSO APPLY WITH RESPECT TO ANY DAMAGES INCURRED BY REASON OF ANY CONTENT OR SERVICES PROVIDED ON ANY THIRD PARTY SITES OR OTHERWISE PROVIDED BY ANY THIRD PARTIES OTHER THAN EASY DIGITAL DOWNLOADS AND RECEIVED BY YOU THROUGH OR ADVERTISED ON THE SITE OR RECEIVED BY YOU ON ANY THIRD PARTY SITES. YOU ALSO AGREE THAT EASY DIGITAL DOWNLOADS WILL NOT BE RESPONSIBLE OR LIABLE FOR ANY LOSS OR DAMAGE OF ANY KIND INCURRED AS THE RESULT OF ANY INTERACTIONS OR DEALINGS WITH ADVERTISERS OR AS THE RESULT OF THE PRESENCE OF SUCH ADVERTISERS ON THE SITE.

Sandhills Development reserves the right to modify, suspend or discontinue the Site and/or Services, or any portion thereof, with or without notice at any time and for any reason, including, but not limited to, a failure to comply with the terms of this Agreement. Sandhills Development shall have no liability whatsoever for any damages, liabilities, losses or any other consequences that you may incur as a result of any such modification, suspension or discontinuance.

Indemnity

You agree to indemnify, defend, and hold harmless Sandhills Development, and its subsidiaries, affiliates, co-branders, all third-party advertisers, technology providers, service providers or other partners, and each of their respective officers, directors, agents, shareholders, employees and representatives, from and against any third party claim, demand, loss, damage, cost, or liability (including, reasonable attorneys’ fees) arising out of or relating to this Agreement or the Site, including but not limited to in relation to: (a) your use, non-use or misuse of, or connection to the Site, the Services and any Content, including without limitation your Content and any third party Content, forming part of the Site; (b) your breach or alleged breach of this Agreement; and (c) your violation of any rights, including intellectual property rights, of a third party. Sandhills Development reserves the right, at your expense, to assume the exclusive defense and control of any matter for which you are required to indemnify Sandhills Development and you agree to cooperate with Sandhills Development defense of these claims. You agree not to settle any matter without the prior written consent of Sandhills Development. Sandhills Development will use reasonable efforts to notify you of any such claim, action or proceeding upon becoming aware of it.

Automatic Renewal

Unless you notify Sandhills Development, LLC before the end of the applicable subscription period that you want to cancel your renewal, your subscription will automatically renew and you authorize us to collect the then-applicable annual or monthly subscription for such Renewal using any credit card or other payment medium we have on record for you. A subscription can be cancelled at any time in the My Account and Billing section of your dashboard.

Cancellation and Termination

If you wish to cancel your Subscription, you can do so by logging into your account and proceeding with this option through the billing section menu. If you are unable to find this option within the billing section or if you have questions or need assistance, please contact Support and they can assist you with the cancellation process. You will remain liable for all charges accrued on your account up to the time that you downgrade or cancel your Subscription, provided however that if you cancel your Subscription within the first fourteen (14) days of opening your Easy Digital Downloads Account, you will receive a refund of your Subscription fee.

Upon cancellation of your Subscription, Sandhills Development is under no obligation to maintain or store your account information or Content. Sandhills Development may, at its option, either delete your information and Content immediately or retain it (in full or in part) in accordance with Sandhills Development’s processes and practices.

Sandhills Development reserves the right at any time, and without cost, charge or liability, to terminate this Agreement at its sole discretion for any reason, including, but not limited to, a failure to comply with the terms of this Agreement. In addition, Sandhills Development may, in its sole discretion, at any time, temporarily or permanently suspend access to your account, Subscription or Services for any violation or suspected violation of this Agreement. Sandhills Development also reserves the right to deny access to anyone, including, but not limited to those users who use proxy servers and/or IP addresses residing in certain geographical areas outside of Canada and the United States. Sandhills Development reserves the right to terminate any portion of the Site at any time, for any reason, with or without notice.

Refund Policy

The Easy Digital Downloads no-risk money back guarantee offers that, if at any time within the first 14 days of opening your paid Account you decide that Easy Digital Downloads is not for you, then just let our awesome support team know (we make it easy!).

We will stop your Subscription and issue you a refund. Your request for a refund must be received within 24 business hours of the 14 days of the date and time of opening your paid Account. While some refunds may be instant, refund credit can take up to 5 – 10 business days to show up in your credit card statement.

If adequate notice is not received and your credit card is subsequently charged, you will not receive a refund. Renewals are non-refundable.

Discount Policy

On occasion, Sandhills Development may offer purchase incentives in the form of subscription discount codes. Discount codes are applied on an introductory basis, meaning that are only applied for the first term of the subscription selected. Discount codes do not perpetuate with the life of the subscription. After your initial term has passed, subscriptions will be charged the regular price.

Agreement to Governing Law and Jurisdiction

If there is any dispute between you and Sandhills Development about or involving this Agreement, the Site or the Services, you hereby agree that the dispute shall be governed by and construed in accordance with the laws of the state of Florida, without regard to its conflict of law provisions. You hereby agree to submit to the exclusive jurisdiction of the courts in West Palm Beach, Palm Beach County, Florida, with respect to any claim, proceeding or action relating to or otherwise arising out of this Agreement, the Site or the Services, howsoever arising, provided always that Sandhills Development may seek and obtain injunctive relief in any jurisdiction.

Severability

If any portion of this Agreement is deemed unlawful, void or unenforceable by any arbitrator or court of competent jurisdiction, this Agreement as a whole shall not be deemed unlawful, void or unenforceable, but only that portion of this Agreement that is unlawful, void or unenforceable shall be stricken from this Agreement.

Legal Remedies

You agree that this Agreement is specifically enforceable by injunctive relief and other equitable remedies without proof of monetary damages.

You agree that if Sandhills Development does not exercise or enforce any legal right or remedy which is contained in the Agreement (or which Sandhills Development has the benefit of under any applicable law), this will not be taken to be a formal waiver of Sandhills Development’s rights and that those rights or remedies will still be available to Sandhills Development.

Surviving Provisions

The sections of “Submission of Content”, “Intellectual Property Rights”, “Confidential Information”, “Disclaimer of Warranties”, “Third Party Sites and Content”, “Limitation of Liability/Exclusion of Consequential and Related Damages”, “Indemnity” and “Agreement to Governing Law and Jurisdiction”, “Severability”, “Legal Remedies”, and any other provisions that by their nature are intended to survive will survive any actual or purported termination of your account or termination or expiration of this Agreement and shall continue in full force and effect.

Manner of Giving Notice

Except as otherwise specified in this Agreement, all notices, permissions and approvals hereunder shall be in writing and shall be deemed to have been given upon: (i) personal delivery, (ii) the second business day after mailing, (iii) the second business day after sending by confirmed facsimile, or (iv) the first business day after sending by email. Billing-related notices to you shall be addressed to the relevant billing contact designated by you. All other notices to you shall be addressed to the relevant contact designated by you.

Miscellaneous

NPS is a registered trademark, and Net Promoter Score and Net Promoter System are service marks, of Bain & Company, Inc., Satmetrix Systems, Inc. and Fred Reichheld.

For any questions, feel free to reach out at 561-408-1057

The post Terms and Conditions and Refund Policy first appeared on Easy Digital Downloads.

To properly protect the files on NGINX, you will need to register a redirect in your site’s server config that prevents users from directly accessing the download files.

Setting up a Web Rule with WPEngine

To get this step please log in to your WPEngine account, select the Site you wish to manage then click on the Web Rules section. Add the following Access Rule:

Type: URI
Operator: Regex matches(~)
Value: ^/wp-content/uploads/edd/\.(jpg|jpeg|png|gif|mp3|ogg|webp)$

This rule will give access to the files with the extensions in the Value field. Every other file type will be blocked so that direct access to your Downloadable files is restricted.

Protecting files on Kinsta

By default, Easy Digital Downloads will protect download files inside of the  wp-content/uploads/edd/ folder with a .htaccess, but this will only work if your site is running on Apache. If your site is running on NGINX, as KInsta uses, the download files will not be protected and will be able to be downloaded by anyone. This doc will walk you through protecting the download files by adding a custom redirect rule to your site’s configuration.

To properly protect the files on NGINX, you will need to register a redirect in your site admin area of your Kinsta site.

Protecting your files on Pantheon

Pantheon does not currently allow custom NGINX rewrite rules. To properly protect your files on Pantheon, you will need to install our Pantheon Compatibility extension and activate it on your website. This plugin converts the standard EDD directory to work within the protected directory provided by Pantheon.

Protecting your files on EasyEngine/Nginx

To protect your EDD files while using EasyEngine and NginX, you must locate where your server{} block lives and add the following line:

location ~ ^/wp-content/uploads/edd/(.*?).zip$ { rewrite / permanent; }

Manually Configuring the Redirect

If you are on a self-hosted VPS or other hosting account, you may need to modify the redirect rules in the server config directly.

If you are manually adding the redirect to your server config, it will look like this, if option 1 doesn’t work, try option 2:

# Option 1:
rewrite ^/wp-content/uploads/edd/(.*).zip$ / permanent;

# Option 2:
rewrite ^/wp-content/uploads/edd/(.*)/(.*).zip$ / permanent;

Keep in mind depending on your hosting provider, it may be required that they implement this for you.

The post Download Files Not Protected on NGINX first appeared on Easy Digital Downloads.

Cheatin’ Eh?!

What it means: This message is one also used in WordPress core, and it always relates to login issues. Sometimes WordPress will actually lose track of your session and log you out altogether, but sometimes WordPress simply loses track of where you are and what you’re doing.

What do to: First press the back button. Once you’re on a regular page, reload that page in your browser and then try again whatever you were doing. The worst that will happen is that WordPress will ask you to log in again.

Trying to cheat or something?

This is identical to Cheatin’ Eh?!

Error Updating Payment

What it means: During the process of updating a payment there was a failure.

What do to: Try saving the payment again.

Invalid Amazon seller ID

What it means: When your store tried to communicate with Amazon using your seller ID it failed for some reason. This could be network problems, a flaw at Amazon, your ID expired, or any number of things.

What do to: Log into your Amazon seller panel and compare the key in your settings with the one at Amazon. If they key is right then it’s almost certainly a network issue or a problem with Amazon. You can wait a few minutes and try again, or submit a support request with Amazon.

Invalid verification token provided.

What it means: When creating a new EDD user, an email is sent to that user with a URL with a code in it. The user must use that URL to prove they have access to that email address. If it fails it means that URL has expired or been tampered with. If the user never uses the URL it may mean they don’t have access to the email provided.

What do to: If the URL is expired or corrupted simply try sending another. If the end user claims they never got the email make sure that the email address on file for them is the proper one.

Missing purchase key.

What it means: Email receipts have a link to view them in a browser, on the store site. A purchase key is included in that URL, and this error appears if that key is NOT included in that URL.

What do to: Make sure there isn’t a line break in the HTML of the email template that would disconnect the URL from the code.

New Customers require a name and email address

What it means: All EDD customers must have at LEAST a name and an email address. This error message should only appear when trying to create a new customer while manually creating a payment.

What do to: Make sure there is a name and email address for the new customer.

Nonce verification failed

What it means: A nonce is simply a little code that is used to keep form submissions from being abused or tampered with. WordPress occasionally loses one or someone may try to tamper with a form, and this error will appear. It’s nothing to be worried about, WordPress knows exactly how to deal with it.

What do to: First try pressing your back button and reloading the page. If the page loads normally then you’re all set and you may try your task again. If that fails you may need to start your form over from the beginning.

Payment ID not supplied. Please try again

What it means: This error comes from the View Order Details page. The URL must include a code that tells EDD what order to display. This error means no code was sent.

What it means: This error comes from the View Order Details page. The URL must include a code that tells EDD what order to display. This error means a code was sent, but was not related to any payment.

What do to: If you’re sure the link was right at some point then the payment related to that id was probably deleted or modified. If you know anything else about the payment you can search for it in the admin area.

Please upload a file to import

What it means: This error comes from the Setting Import tool on the Tools page. It simply means that no file was sent when the Import button was pushed.

What do to: Attach a file before pressing import. If you’re SURE this has been done then there may be an issue with your firewall or server blocking uploads.

Please upload a valid .json file

What it means: This error comes from the Setting Import tool on the Tools page. It means that the file uploaded does not have a .json file extension.

What do to: This tool only reads JSON files. The file you’re uploading must have a .json file extension AND have valid JSON data inside it.

Something went wrong.

What it means: This error occurs only when editing a discount in the admin area. Each discount has a unique numerical ID, and if that doesn’t exist, or isn’t a number you’ll see this error.

The requested price ID does not exist.

What it means: This error occurs when a Buy Now button refers to a price id improperly. This is most common when the button is hand crafted and the price ID is entered improperly.

You do not have permission to edit this payment record

What it means: The user that you’re currently logged in as does not have the proper permissions to edit payment records.

What do to: First make sure you’re logged in as the user you think you are. Then make sure that user is either a Shop Manager or Shop Accountant. You can read about those roles on our Shop User Roles document.

You do not have permission to create discount codes

What it means: The user that you’re currently logged in as does not have the proper permissions to create discount codes.

What do to: First make sure you’re logged in as the user you think you are. Then make sure that user is a Shop Manager. You can read about those roles on our Shop User Roles document.

You do not have permission to edit discount codes

What it means: The user that you’re currently logged in as does not have the proper permissions to edit discount codes.

What do to: First make sure you’re logged in as the user you think you are. Then make sure that user is a Shop Manager. You can read about those roles on our Shop User Roles document.

You do not have permission to delete discount codes

What it means: The user that you’re currently logged in as does not have the proper permissions to delete discount codes.

What do to: First make sure you’re logged in as the user you think you are. Then make sure that user is a Shop Manager. You can read about those roles on our Shop User Roles document.

You do not have permission to delete this customer.

What it means: The user that you’re currently logged in as does not have the proper permissions to delete customers.

What do to: First make sure you’re logged in as the user you think you are. Then make sure that user is a Shop Manager. You can read about those roles on our Shop User Roles document.

You do not have permission to edit this customer.

What it means: The user that you’re currently logged in as does not have the proper permissions to edit customers.

What do to: First make sure you’re logged in as the user you think you are. Then make sure that user is a Shop Manager. You can read about those roles on our Shop User Roles document.

You do not have permission to do shop upgrades

What it means: The user that you’re currently logged in as does not have the proper permissions to update EDD plugins.

You do not have permission to export data.

What it means: The user that you’re currently logged in as does not have the proper permissions to export data.

You do not have permission to generate PDF sales reports

What it means: The user that you’re currently logged in as does not have the proper permissions to generate PDF sales reports.

You do not have permission to install plugin updates

What it means: The user that you’re currently logged in as does not have the proper permissions to update plugins.

You do not have permission to modify this data.

What it means: This error occurs when you’re trying to run the recount function build into EDD. The user that you’re currently logged in as does not have the proper permissions to run that function.

You do not have permission to view this data.

What it means: This error occurs when one user tries to view the data of another user.

What do to: First make sure you’re logged in as the user you think you are. Then make sure that user is a Shop Manager or Administrator. You can read about those roles on our Shop User Roles document.

You do not have permission to view this file.

What it means: This error occurs when one someone tries to view a Download file directly, without going through the proper URL.

What do to: Nothing, this is proper and expected behavior.

You must be logged in to verify your account.

What it means: This error occurs when one someone tries to verify their account without logging in first.

Your account has already been verified.

What it means: This error occurs when one someone tries to verify an account that has already been verified.

The post What is this error, and how do I resolve it? first appeared on Easy Digital Downloads.

By default, download links are valid for 24 hours. The expiration time can be adjusted from the Downloads → Settings → Misc → File Downloads page:

Simply set it to the number of hours you wish download links to be valid for.

Why do download links expire?
The purpose of this feature is to prevent someone from sharing their download links in a public forum. If someone were to share their download link, anyone could use it, but only until it expires (default is 24 hours). This prevents long-term piracy that can harm your store, while also keeping the process simple for normal customers. Once a download link is expired, the customer needs to get a fresh download link if they wish to download. They can do this by logging into their account, or you can re-send their purchase receipt email to them on the Order screen in wp-admin.

It’s important to note that download links are different than the ability to download. An expired download link will not prevent the customer from being able to download their product entirely. A single download link will expire, but if the customer logs in and attempts to download, a fresh download link will be generated for them again. That fresh download link will expire in 24 hours.

To learn more about the ways you can protect your files in Easy Digital Downloads, see the doc on File Downloads in Easy Digital Downloads.

The post Do download links expire? first appeared on Easy Digital Downloads.

This is a payment that has begun, but is not complete. An example of this is someone who has filled out the checkout form and then gone to PayPal for payment. We have the record of sale, but they haven’t completed their payment yet.

This means that Pending isn’t inherently a problem, but it
can be an indication of some other problem. This document will examine some of those possibilities, as well as implications.

What Could It Mean?

There are several different reasons that a transaction could be left as pending.

Abandoned Transactions

Occasionally a customer will put something in their cart, click purchase, go to the payment processor’s page (PayPal for example) and then choose not to finish the transaction. This will leave the transaction as Pending in your store, but not list any transaction at all in your payment processor’s panel. If left alone, the transaction in your store will change its status to Abandoned. This issue doesn’t have a technical problem, and there’s nothing you need to do about it.

Delayed Completion at the Payment Processor

Occasionally payments can be delayed at the Payment Processor, and it’s not always a problem. For example, a large transaction may be flagged as possible fraud, but be sent through upon review and approval by a human at your payment processor. Another example is that you may set up a rule that says payments in a specific currency should be held for review.

There are a number of reasons payment could be delayed at the payment processor, but you should be able to log into the payment processor’s panel and view the transaction and see the delay.

If you log in and do not see any record of the transaction then it’s almost certainly an abandoned payment as mentioned above.

Technical Problems

Once a payment is processed by your payment processor it needs to communicate with your store to indicate a completed sale. If it can’t communicate with your store then your payments will all remain as pending. You can tell if a payment was successfully made by logging into your payment processor’s panel. If you find a transaction that has been fully and properly paid, but remains pending in your store, you’ll know there’s a communication problem there.

The rest of this document discusses how to make your customer happy and find any underlying technical problems.

What Does This Mean For My Customer?

A status of Pending means that the customer does not have access to the product they tried to buy. They don’t get an email about the product, and if they log into your site and look at their product page, it won’t list the product in their download area.

How Can I Make My Customer Happy?

Note: this specific section is not how to fix the underlying problem, but rather how to make your customer happy so you can figure out the problem later.

You can manually complete the sale, which will feel to the customer like the transaction completed normally and they will get their post-sale email and have full access to their purchases.

Note: this should only be done if you have confirmed that the payment was properly made, and money has been accepted from the customer.

To do this, find the transaction on the Payment History page under Downloads → Payment History. Edit the Payment, and find the Meta Box in the top right of the page called Update Payment. Simply change the status from Pending to Complete and press the
Save Payment button.

This will get the customer what they need and you’ll never need to come back to edit this transaction unless it’s for some other need.

Fixing Problems

As mentioned above, a status of Pending isn’t by itself a problem, but can be an indicator of a number of other problems. We have a document called
Payments Not Marked as Complete that explains why and how transactions may not be completed.

The post What does “Pending” mean? Is there a problem? first appeared on Easy Digital Downloads.

This error typically occurs for a couple reasons:

Incorrect PayPal Settings

It’s possible you have entered your PayPal email address or PayPal Identity Token incorrectly. Please confirm your PayPal email address and PayPal Identity Token are entered correctly within Downloads →Settings → Payments → PayPal Standard

Encrypted Website Payments

Your customers may also see this if  Encrypted Website Payments set to ON. Setting it to OFF will resolve the issue. This setting can be adjusted from within your PayPal account by following these steps:

(1) From your PayPal account, hover over the cog in the upper right corner of the screen and click Account Settings
(2) On the next screen, click Website Payments on the lower left
(3) On the right side of the screen, click Update next to “Website preferences”
(4) Make sure the option under “Encrypted website payments” is set to OFF

Will turning off Encrypted Website Payments be less secure?

EDD has full verification of payments to ensure the data isn’t tampered with. 

Can EDD work with Encrypted Website Payments enabled?

Yes. In order to utilize PayPal’s Encrypted Website Payments, you need to upload a public certificate to PayPal: https://www.paypal.com/us/smarthelp/article/how-do-i-create-a-public-certificate-for-use-with-paypal-encrypted-website-payments-ts1021

There is a problem with your PayPal account

This error can occur if your new account isn’t fully setup or if PayPal locked it down. Please reach out to PayPal to confirm you account is in good standing and there are no problems.

The post PayPal Error: Things don’t appear to be working at the moment. first appeared on Easy Digital Downloads.

See https://schema.org/docs/schemas.html for details.

Where does the schema output?

As of EDD 3.0, the schema data is output only on the single download pages, as per the Google guidelines for product schema. The structured data is in the JSON+LD format, and is included at the bottom of the page in a <script> tag.

How can I modify the structured data that is output?

Easy Digital Downloads generates the structured data based on the content you provide when editing a download. This includes the product title, variation name (if variable pricing is enabled), price, currency, your organization name, URL to the product and many other necessary structured data values. If you need to modify this data, we provide a filter that developers can use to alter the data prior to it’s output. That filter is edd_generate_download_structured_data. This will be an array of the structured data that we found for your product, and is expecting that array to be returned in the same format.

How can I disable schema output?

Some SEO plugins like All in One SEO and Yoast are directly integrated with EDD’s product data and will also output a product’s structured data as well. If you would like to use structured data from another plugin, instead of EDD’s, you can use the following code snippet to remove the data automatically output by EDD.

 remove_filter( 'wp_footer', array( EDD()->structured_data, 'output_structured_data' ) ); 

We recommend a plugin like WPCode to add custom snippets to your site, as it helps prevent fatal errors and will remain in place, even if you change themes.

What if I’m still using EDD 2.x?

For EDD versions 2.x you can disable with the following filter:
add_filter( 'edd_add_schema_microdata', '__return_false' );

Help, I’m seeing a deprecated function notice for edd_add_schema_microdata.

In older versions of Easy Digital Downloads, we would output the schema data inline on the product purchase buttons and product pages. Many themes that integrate with Easy Digital Downloads had customized the product lists and product pages, and therefore used this function to ensure that the structured data remained in their designs for search engines to find.

As of EDD 3.0, this method of outputting the data is officially deprecated as it is using an old product schema format, however some themes or custom template files may still use this function in their code.

If a theme, plugin, or custom code is using this function directly you will see this error message in your PHP error logs, or on your site if WordPress’s debug mode is enabled:

Notice: edd_add_schema_microdata is deprecated since Easy Digital Downloads version 3.0! Use EDD_Structured_Data instead

If you are seeing this notice in your PHP error logs or on your site, this means that another plugin or your theme are calling the function directly. To resolve this you will need to do one of the following:

A theme or plugin I’m using is causing this error:

You need to reach out to the developer of the theme or plugin and ask them to no longer use the edd_add_schema_microdata function in their code. It might be helpful to send them a link to this documentation so they can learn more about our updated structured data implementation.

I am a theme or plugin developer and my code is using this edd_add_schema_microdata function:

If your plugin or theme is using the edd_add_schema_microdata function, it can be removed as it is no longer supported. We’ve moved to using the new JSON+LD structured data format which outputs in the suggested locations, as per the schema and Google guidelines for product data.

The post Schema and Structured Data Support first appeared on Easy Digital Downloads.

If this happens, you will see a folder in your downloads folder instead of the “.zip” file. You cannot upload and install a plugin on your WordPress site unless it’s a “.zip” file. It’s just the way WordPress works.

You’ll need to disable this setting on your web browser and download the plugin “.zip” file again.

Quick workaround: right-click

One quick way to get around this problem is to right-click (or Control-click on a laptop) the link or button and choose the option “Download Linked File As…”, which will allow you to download the plugin as the “.zip” file required for WordPress installation.

Note that your browser may default to saving the file wherever the last file was saved, which may not necessarily be your default download location set under your browser settings.

Disabling the automatic un-zip for Safari

Another way around this problem is to disable the “Open “safe” files after downloading” setting. Apple often refers to “.zip” files as ‘archives’ or ‘archive files’.

1. Under the ‘Safari’ menu item click Preferences
2. On the General tab, which should open first automatically look at the bottom of the options presented
3. Un-check the box next to “Open “safe” files after downloading” option.

Automatic un-zip for other web browsers

Most other web browsers do not automatically un-zip files. Below are some details on specific web browsers. Please note; web browsers are always changing quickly, we will update this information as often as possible. The support links provided below will have the most up-to-date information.

Chrome

Chrome, by default does not automatically un-zip “.zip” files. If this is happening, you likely have an extension installed, which you can temporarily disable and then re-download the plugin “.zip” file.

Firefox

Firefox, by default does not automatically un-zip “.zip” files. If this is happening there is likely an application setting that may have been enabled that you can disable.

1. Go to the settings/preferences (varies between PC and Mac)
2. Search ‘zip’ in the settings search bar under settings
3. Under application settings locate the “.zip” file settings
4. Make sure it is set to ‘Save file’.

Microsoft Edge

Microsoft Edge, by default does not automatically un-zip “.zip” files. If this is happening, navigate to Edge Settings > Downloads and turn on “Ask me what to do with each download”.

Other

Please check your web browser’s help tab or visit their website and look for the support or documentation section.

The post Zip file automatically un-zips upon download first appeared on Easy Digital Downloads.

The issue is often caused by the EDD store’s server terminating the connection early. This could be because the file is too large. Otherwise, due to the fact PHP is running a thread/process required to deliver the file to your customer. We recommend reaching out to your host to review the server logs and increase the the timeout/expiration on your server, allowing the customer to download the file without it timing out. 

Another cause could be caching. Gzip compression could cause this but as a troubleshooting step, all cache should be temporally disabled to see if that resolves the error.

Depending on the quality and limitations of your web host, a more stable long term solution would be hosting your files on Amazon S3, Dropbox or GitHub. This would address most download issues you face as the files will be served directly from Amazon, rather than your server.

The post Download fails due to Network Error first appeared on Easy Digital Downloads.