Frontend Submissions – Easy Digital Downloads Documentation https://easydigitaldownloads.com Sell Digital Products With WordPress Fri, 07 Mar 2025 22:08:15 +0000 en-US hourly 1 https://wordpress.org/?v=6.8.2 https://easydigitaldownloads.com/wp-content/uploads/2023/10/cropped-new-favicon-1-32x32.png Frontend Submissions – Easy Digital Downloads Documentation https://easydigitaldownloads.com 32 32 Frontend Submissions – Product Moderation and Approval https://easydigitaldownloads.com/docs/frontend-submissions-product-moderation-and-approval/ Mon, 24 Jan 2022 19:56:05 +0000 https://edd-site.lndo.site/docs/frontend-submissions-product-moderation-and-approval/ With Frontend Submissions the site owner can allow Vendors to add new products freely without review, or the site owner can require that each submission be held for moderation. Moderation If the Frontend Submissions settings are set to require admin approval for uploads then the product will show in the Vendor dashboard under Products, but

The post Frontend Submissions – Product Moderation and Approval first appeared on Easy Digital Downloads.

]]>
With Frontend Submissions the site owner can allow Vendors to add new products freely without review, or the site owner can require that each submission be held for moderation.

Moderation

If the Frontend Submissions settings are set to require admin approval for uploads then the product will show in the Vendor dashboard under Products, but not on the front end of the site. This setting can be enabled or disable by navigating to EDD FES → Settings → Permissions.

When a Vendor submits a product, an email is sent to the site admin and the product is inserted into the database as Pending.

Here’s an example of a Pending product and some approved/live products.

Approval

If product uploads are set to be moderated, the store admin will need to navigate to Downloads → All Downloads to approve them.

Here’s an example:

To approve the product, hover over the product name and click Approve, OR edit the product and change its status to “Publish”.

Decline

When a product is pending review, place the product in Trash to Decline the submission of that product. The vendor will receive the Submission Declined email, if it’s enabled.

Revoke

To revoke a Vendor’s approved product, place the product in the Trash and it will be revoked. The vendor will receive the Submission Revoked email, if it’s enabled.

The post Frontend Submissions – Product Moderation and Approval first appeared on Easy Digital Downloads.

]]>
Frontend Submissions – Tools https://easydigitaldownloads.com/docs/frontend-submissions-tools/ Mon, 24 Jan 2022 19:55:50 +0000 https://edd-site.lndo.site/docs/frontend-submissions-tools/ Front End Submissions has a number of Import, Export, and Reset tools for FES forms. You can access these options by navigating to EDD FES → Tools. These tools are specifically related to the forms that FES uses, and are for importing, exporting, and resetting the forms. Import Form This option will allow you to

The post Frontend Submissions – Tools first appeared on Easy Digital Downloads.

]]>
Front End Submissions has a number of Import, Export, and Reset tools for FES forms. You can access these options by navigating to EDD FES → Tools. These tools are specifically related to the forms that FES uses, and are for importing, exporting, and resetting the forms.

Import Form

This option will allow you to import a JSON file with the proper settings from an FES form export. With this tool you can move form settings from one site to another or make a backup.

Export Form

This option will allow you to make an export of your form settings, for moving to another site or backing up.

Reset Form

This option allows you to select a form and reset it to the default fields and options that it came with.

Reset All Forms

This option is similar to the Reset Form option except it resets all FES forms to their default fields and options.

Reset Meta For All Forms

Front End Submissions 2.3 added meta information to forms. This option resets all of that information, and should not be used without first consulting with EDD support.

Delete Extraneous Forms

This action deletes all FES Forms which are not assigned to a form in the FES Settings Panel. 

Import Pre-FES 2.4 Settings

This option allows you to take a form settings JSON file from a version of FES older than 2.4 and import them. This should only be done as part of a restore process in the event that migrating from pre-2.4 to 2.4 causes issues.

Export Pre-FES 2.4 Settings

This option allows you to export pre-2.4 settings so that you may re-import them during a migration.

Recount Vendor Statistics

This option allows you to recount Vendor earnings, sales, and download counts.

The post Frontend Submissions – Tools first appeared on Easy Digital Downloads.

]]>
Frontend Submissions – Extension Compatibility https://easydigitaldownloads.com/docs/frontend-submissions-extension-compatibility/ Mon, 24 Jan 2022 19:55:41 +0000 https://edd-site.lndo.site/docs/frontend-submissions-extension-compatibility/ Frontend Submissions is compatible with many Easy Digital Downloads extensions. Amazon S3 Frontend Submissions is fully compatible with the Amazon S3 extension with some minor behavioral changes. Uploading works exactly the same, but Vendors may not browse the server. If they need to change files, the site admin must upload a new one. If they

The post Frontend Submissions – Extension Compatibility first appeared on Easy Digital Downloads.

]]>
Frontend Submissions is compatible with many Easy Digital Downloads extensions.

Amazon S3

Frontend Submissions is fully compatible with the
Amazon S3 extension with some minor behavioral changes. Uploading works exactly the same, but Vendors may not browse the server. If they need to change files, the site admin must upload a new one. If they need to revert, they cannot browse to the original file, and they have to re-upload that original file. Read more information about Amazon S3 and Frontend Submissions here.

Commissions

Frontend Submissions is fully compatible with the
Commissions extension. You can read about how that integration works in this document.

Custom Deliverables

With Frontend Submissions and
Custom Deliverables your Vendors can deliver customized files to their customers. See Custom Deliverables – Frontend Submissions Integration for details.

Dropbox

The Dropbox File Store extension is
incompatible with Frontend Submissions.

EDD Message

EDD Message integrates perfectly with Frontend Submissions. With both active, it is possible to send unique, custom messages directly to Vendors. Additionally Vendors can send messages directly to their own customers.

Purchase Limit

There’s no direct integration between
Purchase Limit and Frontend Submissions, but if you add a text field to your Submission Form and give it a meta key of
_edd_purchase_limit, the value entered by the Vendor will be set as the limit. Please note this will only work if the Vendor is submitting a single priced product. If they are using variable prices, this method will not work. The site owner would have to edit the submitted product(s) manually.

Recurring Payments

Recurring Payments and Frontend Submissions are not fully integrated. Vendors will not be able to set recurring payment details in the submission form. However, recurring payment functionality can be enabled for vendor-uploaded products through the Edit Download screen by the site owner once submitted.

Simple Shipping

When
Simple Shipping and Frontend Submissions are both active, a “Shipping” field will become available in the “Add Extension Created Fields” section of the Submission Form. When this field is added to the Submission Form, Vendors will be able to define their own international and domestic shipping rates for each product. Additionally, if a Country field is added to the Vendor profile form with the meta key “vendor_country”, shipping calculations at checkout will be based on that value instead of the one saved in the Simple Shipping settings. See detailed instructions here.

Slack

EDD Slack includes an integration with Frontend Submissions. With EDD Slack it is possible to receive notifications within your Slack channels when Vendors register, submit products, and edit products as well as when customers contact Vendors. Additionally, EDD Slack can include interactive buttons within notifications for Vendor applications, submissions, and product edits so you can approve or reject the request right from Slack without having to login to your WordPress dashboard.

Software Licensing

The
Software Licensing extension is incompatible with Frontend Submissions.

Other Plugins

If you think perhaps you’ve found a conflict, or are wondering about a specific plugin, feel free to
open a support ticket and we’ll be happy to answer your questions.

The post Frontend Submissions – Extension Compatibility first appeared on Easy Digital Downloads.

]]>
Amazon S3 and Frontend Submissions https://easydigitaldownloads.com/docs/amazon-s3-and-frontend-submissions/ Mon, 24 Jan 2022 19:55:37 +0000 https://edd-site.lndo.site/docs/amazon-s3-and-frontend-submissions/ The Amazon S3 extension and Frontend Submissions can be used together so that files uploaded by Vendors through the Vendor Dashboard are transferred automatically to your Amazon S3 account. All files uploaded by Vendors will be automatically placed in the default bucket you have selected in the Amazon S3 settings. Within the default bucket, a

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

]]>
The Amazon S3 extension and Frontend Submissions can be used together so that files uploaded by Vendors through the Vendor Dashboard are transferred automatically to your Amazon S3 account.

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

Folder Name Setting

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

Prices and Files Form

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

Amazon S3 Uploader

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

Important Note:

This uploader is not used for customer files; this is only for accessing files via the WordPress Dashboard.

Notes:

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

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

]]>
Integration Guide: Frontend Submissions and Simple Shipping https://easydigitaldownloads.com/docs/integration-guide-frontend-submissions-and-simple-shipping/ Mon, 24 Jan 2022 19:55:29 +0000 https://edd-site.lndo.site/docs/integration-guide-frontend-submissions-and-simple-shipping/ Easy Digital Downloads and Frontend Submissions are designed to sell digital products. However, there are occasions when physical goods which are subject to shipping charges need to be sold as well in the same store. For this reason we created our Simple Shipping extension, which adds basic features for setting shipping costs on any applicable

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

]]>
Easy Digital Downloads and Frontend Submissions are designed to sell digital products. However, there are occasions when physical goods which are subject to shipping charges need to be sold as well in the same store. For this reason we created our Simple Shipping extension, which adds basic features for setting shipping costs on any applicable product. Below you can read how the Simple Shipping extension integrates with the Frontend Submissions extension.

Adding shipping to the submission form

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

Basing shipping costs on vendor location

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

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

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

]]>
Frontend Submissions Developer Documentation https://easydigitaldownloads.com/docs/frontend-submissions-developer-documentation/ Mon, 24 Jan 2022 19:55:23 +0000 https://edd-site.lndo.site/docs/frontend-submissions-developer-documentation/ Frontend Submissions has a number of features that can be used programmatically.  Make a User a Vendor Frontend Submissions has a helper function called  make_user_vendor() which does two things at once: makes a user into a vendor changes the status on that new vendor to Approved It can be run anywhere, and looks like this:

The post Frontend Submissions Developer Documentation first appeared on Easy Digital Downloads.

]]>
Frontend Submissions has a number of features that can be used programmatically. 

Make a User a Vendor

Frontend Submissions has a helper function called  make_user_vendor() which does two things at once:

  • makes a user into a vendor
  • changes the status on that new vendor to Approved
It can be run anywhere, and looks like this:
EDD_FES()->vendors->make_user_vendor( $user_id );

Important: the ID parameter used above is the WordPress user ID.

Change a Vendor’s Status

There are three statuses that a Vendor may have:

  • Approved
  • Pending
  • Suspended

There are also two actions that may be taken:

  • Unsuspend
  • Revoke

All of these use the same method, but statuses and actions are different things.  Here’s how it works.

First you must instantiate an Frontend Submissions object like one of these:

// Example showing required input
$vendor = new FES_Vendor( $_id_or_email = false, $by_user_id = false );
// using a vendor ID
$vendor = new FES_Vendor( 14, false );

// using the email address associated with the vendor ID
$vendor = new FES_Vendor( 'user@example.com', true );

Secondly, you run the change_status() method on that object, similar to one of these examples:

// Example showing required input
$vendor->change_status( $new_status = '', $in_admin = false, $output = false );

The $in_admin input allows you to declare whether this action should be allowed in the context of admin area, or outside of it. You may wish to allow this change inside the admin area, but not outside the admin area for example.

// Set a vendor to approved, inside the admin area, with no output
$vendor->change_status( 'approved' );

// Set a vendor to pending, outside the admin area, with no output
$vendor->change_status( 'pending', true );

// Set a vendor to suspended, outside the admin area, with no output
$vendor->change_status( 'suspended', true, true );

In addition to the above status changes, you can run these actions:

// Revoke a vendor, inside the admin area, with no output.  
// This will effectively make a user NOT a vendor, and remove all their products.
$vendor->change_status( 'revoke' );

// Changes a user from suspended to approved. At this point identical to setting
// a user to approved, but in the future may contain some additional features.
$vendor->change_status( 'unsuspend' );

The post Frontend Submissions Developer Documentation first appeared on Easy Digital Downloads.

]]>
Integration Guide: Commissions and Frontend Submissions https://easydigitaldownloads.com/docs/integration-guide-commissions-and-frontend-submissions/ Mon, 24 Jan 2022 19:55:12 +0000 https://edd-site.lndo.site/docs/integration-guide-commissions-and-frontend-submissions/ The EDD Frontend Submissions extension and the EDD Commissions automatically integrate together to make it easy to pay Vendors commissions for sales of their products. Set Up Instructions: EDD Commissions and EDD Frontend Submissions extensions should both be installed and activated in the “Plugins” page in your WordPress Dashboard. How the integration works: When your

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

]]>
The
EDD Frontend Submissions extension and the EDD Commissions automatically integrate together to make it easy to pay Vendors commissions for sales of their products.

Set Up Instructions:

EDD Commissions and EDD Frontend Submissions extensions should both be
installed and activated in the “Plugins” page in your WordPress Dashboard.

How the integration works:

When your Vendors submit a new product for sale through Frontend Submissions, commissions will automatically be enabled for that product and the commission recipient will automatically be set to that Vendor. Their commission rate in the product itself will be left blank and the default commission rate will be used. The amount that is automatically applied is either based on the Default rate from the Commissions settings or User Global Rate. These default rates are used when the rate in the product settings is left blank.

Note: The Commission Rates inside the product setting is not automatic, if black it utilizes one of the default rates but if the rate is set, it will override the default and global rates.

User Rate

User rates can be set on a per-user basis. This would be used if you want to set different rates for different vendors. If you want all users to have the same commission rate, the user rate would be left blank. This setting will override the Default Rate set in the Commisions settings.

When your Vendors submit a new product for sale through Frontend Submissions, commissions will automatically be enabled for that product and the commission recipient will automatically be set to that Vendor. Their commission rate in the product itself will be left blank. This means that their commission rate will fall back to their User Rate, which you can configure for each Vendor by editing their user profile under: Users → User’s Global Rate

Commissions Default Rate

The commissions’ default rate applies to all commissions where the User Rate and Product rate are blank.

This can be set under: Downloads → Settings → Extensions → Commissions → Default rate

More details about setting commissions rates can be found here.

Override Site Default and User Default rate

If you wish to override the Site Default and User Default rates for any individual product, set the rate in the product itself by editing that product and going to the “Commissions” metabox. There, you can enter a commission rate for that Vendor for that specific product only.

Note: The Product rate is used first. If it is blank, then the User rate is used. If that is also blank, the Site default rate is used.

Setting Vendor Paypal Emails upon registration

If you are paying your Commissions through Paypal and want to make sure your Vendors enter a Paypal email when registering, there is a field available when both Frontend Submissions and Commissions are active. Navigate to
EDD FES Registration Form Add Extension Created Fields Paypal Email


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

]]>
Frontend Submissions – Email Configuration https://easydigitaldownloads.com/docs/frontend-submissions-email-configuration/ Mon, 24 Jan 2022 19:54:41 +0000 https://edd-site.lndo.site/docs/frontend-submissions-email-configuration/ Frontend Submissions can send emails to both site administrators and Vendors for a variety of reasons. You can configure the contents of these emails by navigating to Downloads > Emails > Frontend Submissions. Template Tags In the emails that the Vendor and admins receive regarding applications (application received/approved/denied), the following template tags can be inserted: {firstname} – The

The post Frontend Submissions – Email Configuration first appeared on Easy Digital Downloads.

]]>
Frontend Submissions can send emails to both site administrators and Vendors for a variety of reasons. You can configure the contents of these emails by navigating to Downloads > Emails > Frontend Submissions.

Template Tags

In the emails that the Vendor and admins receive regarding applications (application received/approved/denied), the following template tags can be inserted:

{firstname} – The first name of the Vendor
{lastname} – The last name of the Vendor
{fullname} – The full name of the Vendor (first + last name: John Smith)
{username} – The username of the Vendor
{vendor-email} – The email address of the Vendor
{sitename} – The name of our site, as defined by the “Site Name” settings located in Settings → General of the WordPress Dashboard

On the emails that the Vendor and admins receive regarding Submissions, the following template tags can be used:

{firstname} – The first name of the Vendor
{lastname} – The last name of the Vendor
{fullname} – The full name of the Vendor (first + last name: John Smith)
{username} – The username of the Vendor
{vendor-email} – The email address of the Vendor
{sitename} – The name of our site, as defined by the “Site Name” settings located in Settings → General of the WordPress Dashboard
{post-title} – The name of the submission
{post-content} – The content (description) of the submission
{post-categories} – The Category the submission is in
{post-tags} – The Tags the submission has
{post-date} – The date the submission was submitted
{post-status} – The current status of submission (Pending Review, Published, Trashed)

 When customizing the emails for Frontend Submissions you can use the Insert Marker button to easily add one of the available email tags.

Sample Emails

Admin Emails:

New Vendor Application:

{fullname} has applied to become a vendor.

Submission Received:

Vendor {fullname} – {vendor-email} has submitted the following submission for review:
Name of Submission: {post-title}
Content of Submission: {post-content}
Submission Category: {post-categories}
Submission Tags: {post-tags}
Date of Submission: {post-date}

Vendor Emails:

Vendor Application Received:

Dear {firstname},
Your application to become a vendor has been received.

Regards,
{sitename}

Vendor Application Approved:

Dear {firstname},
Your application to become a vendor has been approved!

Regards,
{sitename}

Vendor Application Denied:

Dear {firstname},
Your application to become a vendor has been declined.

Regards,
{sitename}

Submission Received:

Dear {firstname},
Your submission, {post-title}, has been received.

Regards,
{sitename}

Submission Approved:

Dear {firstname},
Your submission, {post-title}, has been approved!

Regards,
{sitename}

Submission Declined:

Dear {firstname},
Your submission, {post-title}, has been declined.

Regards,
{sitename}

Note: The Frontend Submission plugin does not include a feature to email Vendors when their products have sold. This is because the Frontend Submissions plugin does not handle the actual payment to any of the Vendors. If desired, it can be done by using the EDD Commissions extension and setting the commission to zero, which will still send an email to a Vendor when their product is purchased.

The post Frontend Submissions – Email Configuration first appeared on Easy Digital Downloads.

]]>
Frontend Submissions – Vendor Shop Pages https://easydigitaldownloads.com/docs/frontend-submissions-vendor-shop-pages/ Mon, 24 Jan 2022 19:54:36 +0000 https://edd-site.lndo.site/docs/frontend-submissions-vendor-shop-pages/ With Frontend Submissions, each Vendor has its own Shop page, which is an archive of its products. The parent Vendor page is a normal WordPress Page with the [downloads] shortcode on it. You can choose what page that is in FES > Settings > Forms/Pages. Assuming your Vendor Page has a slug of “vendor”, then

The post Frontend Submissions – Vendor Shop Pages first appeared on Easy Digital Downloads.

]]>
With Frontend Submissions, each Vendor has its own Shop page, which is an archive of its products. The parent Vendor page is a normal WordPress Page with the [downloads] shortcode on it. You can choose what page that is in FES > Settings > Forms/Pages.

Assuming your Vendor Page has a slug of “vendor”, then you can append the username of any vendor to the URL to get that vendor’s personal Shop page.

Example with the Vendor being used in this documentation: http://eddstoredomain.com/vendor/vendorredirecttest/

Below is an example of Vendor Shop page.

The post Frontend Submissions – Vendor Shop Pages first appeared on Easy Digital Downloads.

]]>
Frontend Submissions – Vendor Accounts https://easydigitaldownloads.com/docs/frontend-submissions-vendor-accounts/ Mon, 24 Jan 2022 19:54:27 +0000 https://edd-site.lndo.site/docs/frontend-submissions-vendor-accounts/ With Frontend Submissions, if you wish to allow vendors to register accounts, you will have to enable the functionality from the settings page. The option to enable or disable vendor registrations can be found by navigating to Downloads > Settings > FES > Permissions. If Vendor registration is open to all then the end user

The post Frontend Submissions – Vendor Accounts first appeared on Easy Digital Downloads.

]]>
With Frontend Submissions, if you wish to allow vendors to register accounts, you will have to enable the functionality from the settings page. The option to enable or disable vendor registrations can be found by navigating to Downloads > Settings > FES > Permissions.

If Vendor registration is open to all then the end user may go to your Vendor Registration Page to sign up. When someone signs up as a Vendor, they will be assigned the user role of Subscriber unless they already had a WordPress user account with a different user role.

Registration

If the end user is not signed in as a WordPress user, this is the form they will see:

If the end user is already signed in as a WordPress user, this is the form they will see.  This form is much simpler because it’s taking existing information from the WordPress user:

After Registration

After completion of the registration form, the new Vendor will see one of two things:

  1. If you have auto-approval turned on then they are sent directly to the Seller Dashboard where they can begin adding products
  2. If you have auto-approval turned off then they will see a message that says “Your application is pending”. The store administration will receive an email alerting them to the fact that a new Vendor registration requires approval.

Manually Grant Vendor Status

To manually make any WordPress user into an FES Vendor, browse to their WordPress profile page. Find the section titled “Easy Digital Downloads Frontend Submissions.” In that section there is a link titled Make Vendor. Simply clicking that link will make that user a Vendor.

This same area can be used to see that a user is a Pending Vendor, and link to the Vendor Profile. In the Vendor Profile a user can be Approved as a Vendor.

Vendor Management

You may manage Vendors by navigating to Downloads > Vendors. Note, this title may be different if you’ve changed the “Vendors” text to something else.

Here you’ll see a list of all Vendors currently on the website. Hovering over a Vendor name will allow you to View, Approve, or Reject the application as well as options to Suspend or Delete active Vendors.

If you click the View link then you’ll be taken to the Vendor Details page. The Vendor information area uses a tabbed interface, with the tabs along the left side.

Vendor Status

Pending: While in pending status a vendor cannot submit products to the marketplace.

Approved: An Approved vendor can submit products to the marketplace.

Suspended: A Suspended vendor cannot submit products. Any of their products that are Live will be set to Draft when their role is set to Suspended. Vendors can be set back to Approved at any time by the store admin. Any of their products that were previously live will get set back to Live.

Vendor Overview

The first tab is the Vendor Overview.

The Vendor Overview tab contains:

  • Vendor name
  • Vendor email
  • Vendor sign-up date
  • WordPress User ID
  • Vendor status
  • Vendor mailing address (if applicable)
  • Number of sales
  • A list of products
  • A button to Delete this Vendor
  • A button to Suspend this Vendor
  • A link to edit the information on this panel

Vendor Notes

The Vendor Notes tab is designed for site administrators to make private notes about Vendors. These notes are visible ONLY to site administrators. Below is an example with one note.

Vendor Registration

This tab allows site administrators to change the Vendor’s information including the following:

  • First Name
  • Last Name
  • Email Address
  • Display Name

Vendor Profile

This tab sets the name of the Vendor’s store as well as allowing for a custom email address for the Vendor contact form.  If no email address is provided, the address from the WordPress user profile will be used. Other fields available in the Profile form are editable in this area as well.

Vendor Products

This tab lists all of the Vendor’s products, showing ID, Title, Status, and number of sales. Titles are links to the product admin pages. There’s also a sum of the number of sales if more than one.

Vendor Reports

This tab can show both earnings and sales over time. It can be filtered to show

  • Today
  • Yesterday
  • This Week
  • Last Week
  • This Month
  • Last Month
  • This Quarter
  • Last Quarter
  • This Year
  • Last Year

Vendor Exports

This tab allows the site administrator to download a PDF with Sales and Earnings for the current year as well as a Customer list for any given product or all products. The customer list could be emails only or emails and names. The customer list is delivered in CSV format.

Vendor Deletion

The Delete tab allows a site owner to delete a Vendor as well as choose to delete their products or attribute them to another user.

The post Frontend Submissions – Vendor Accounts first appeared on Easy Digital Downloads.

]]>
Frontend Submissions – Vendor Dashboard https://easydigitaldownloads.com/docs/frontend-submissions-vendor-dashboard/ Mon, 24 Jan 2022 19:54:24 +0000 https://edd-site.lndo.site/docs/frontend-submissions-vendor-dashboard/ The Vendor Dashboard in Frontend Submissions is an administration area for Vendors. This page can be set by navigating to EDD FES → Settings → Forms/Pages. This page must contain the [fes_vendor_dashboard] shortcode. From this dashboard Vendors may  Manage Products Add Products View and Manage Orders Edit their store profile Log out If the site

The post Frontend Submissions – Vendor Dashboard first appeared on Easy Digital Downloads.

]]>
The Vendor Dashboard in Frontend Submissions is an administration area for Vendors. This page can be set by navigating to EDD FES → Settings → Forms/Pages. This page must contain the [fes_vendor_dashboard] shortcode.

From this dashboard Vendors may 

  • Manage Products
  • Add Products
  • View and Manage Orders
  • Edit their store profile
  • Log out

If the site owner has added a Vendor Announcement (EDD FES → Settings → Main Settings) it will show on this page.

Last is a Comments section, which is an aggregate of all comments on products owned by this Vendor (if applicable).

Products

The Vendor can View, Edit, or Delete any of their products. 

Add Product

Here, a Vendor can add a new product. The fields available are determined by how the site owner populates the Vendor Submission Form. 

Orders

The Vendor can see all orders from their store as well as view each order.

When clicking “View” on an order, the Vendor is presented with a full record of the order. 

Profile

The Vendor will be able to edit their profile information.

The post Frontend Submissions – Vendor Dashboard first appeared on Easy Digital Downloads.

]]>
Frontend Submissions – Form Builder https://easydigitaldownloads.com/docs/frontend-submissions-form-builder/ Mon, 24 Jan 2022 19:54:01 +0000 https://edd-site.lndo.site/docs/frontend-submissions-form-builder/ Frontend Submissions uses a number of forms that need to be created by the site owner for use by the Vendors. FES facilitates this by including a full featured Form Builder.  If you’re familiar with some other common form builders like Gravity Forms, Ninja Forms, or Caldera Forms, you’ll see that the FES form builder

The post Frontend Submissions – Form Builder first appeared on Easy Digital Downloads.

]]>
Frontend Submissions uses a number of forms that need to be created by the site owner for use by the Vendors. FES facilitates this by including a full featured Form Builder. 

If you’re familiar with some other common form builders like Gravity Forms, Ninja Forms, or Caldera Forms, you’ll see that the FES form builder has similar functionality. 

The form builder is used for the Vendor Submission/Registration Form as well as the Vendor Profile Form.

Clicking the buttons in the right column will add the associated fields to the form editor on the left. Depending on which form you’re editing, the options will change.

Submission Form Fields, Registration Form Fields, and Profile Form Fields options are related to each form being created/edited, while the Add Custom Fields options are available for all forms and include things like Text Areas, Dropdowns, etc. Add Extension Created Fields will show fields available that have been added by other Easy Digital Downloads extensions (if applicable).

Built-In Examples

Below is an example of one of the simplest built-in fields, Title.

Required: Choose whether the field should be required or not.

Field Label: Choose the title of the field.

Help Text: This is text that will appear under the title (similar to a sub-heading). This would be used to describe in more detail what information you’re asking for in the field.

CSS Class Name: You can add a class name here, so that the field could be styled through custom CSS if needed.

Size: You can choose the size of the text field. 40 is default.

Custom Examples

A custom field would be a traditional HTML form field, but one that doesn’t save its data in a predefined WordPress location like Title and Body.

Text Field

Below is an example of a plain text input field.  Because this is a custom field the data will get saved in a meta table in WordPress, and therefore the Meta Key field is required.
Custom fields also have the option to show the information on the front end with the product’s information/description.

Note: When using the “Post Format” option, ensure that the active theme supports Post Formats or this option will not work as intended.

Action Hooks

The Action Hook button doesn’t make a form field. Instead, it inserts a location for you to create a hook. Instructions for using it are included in the form builder itself, as seen below. This requires knowledge of coding and is meant for more experienced users.

Data Storage

The Registration form creates a WordPress user, so all meta information is stored in the
usermeta WordPress table.

The Profile form is also related to users, so its meta information is also stored in the
usermeta WordPress table.

The Submission form stores its data in a custom content type in the WordPress posts table, so all meta data is stored in the
postmeta WordPress table.

The post Frontend Submissions – Form Builder first appeared on Easy Digital Downloads.

]]>
Frontend Submissions – Shortcodes https://easydigitaldownloads.com/docs/frontend-submissions-shortcodes/ Mon, 24 Jan 2022 19:53:53 +0000 https://edd-site.lndo.site/docs/frontend-submissions-shortcodes/ Frontend Submissions includes several shortcodes for displaying the submission forms, vendor dashboard, profile form, and more. [fes_vendor_dashboard] – This will display the main Vendor dashboard. [fes_submission_form] – This will display the Vendor product submission form. [fes_profile_form] – This will display the Vendor’s profile form. [fes_login_form] – This will display a login form for Vendors [fes_registration_form] – This will display a registration

The post Frontend Submissions – Shortcodes first appeared on Easy Digital Downloads.

]]>
Frontend Submissions includes several shortcodes for displaying the submission forms, vendor dashboard, profile form, and more.

[fes_vendor_dashboard] – This will display the main Vendor dashboard.

[fes_submission_form] – This will display the Vendor product submission form.

[fes_profile_form] – This will display the Vendor’s profile form.

[fes_login_form] – This will display a login form for Vendors

[fes_registration_form] – This will display a registration form for new Vendors.

[fes_login_registration_form] – This will display both the vendor registration and login form together.

[fes_vendor_contact_form] – This will display a contact form for the currently viewed vendor. A contact form for a specific vendor can be displayed with [fes_vendor_contact_form id=”32″] where 32 is the ID number of the vendor.

The post Frontend Submissions – Shortcodes first appeared on Easy Digital Downloads.

]]>
Frontend Submissions – Frequently Asked Questions https://easydigitaldownloads.com/docs/frontend-submissions-frequently-asked-questions/ Mon, 24 Jan 2022 19:53:52 +0000 https://edd-site.lndo.site/docs/frontend-submissions-frequently-asked-questions/ Below are questions related specifically to the Frontend Submissions extension for Easy Digital Downloads. Does Frontend Submissions work with PHP 7? Yes, starting with FES version 2.4. Why do my Vendor pages show a 404 error? Typically this can be resolved by navigating to Settings → Permalinks and click the Save Changes button. No changes

The post Frontend Submissions – Frequently Asked Questions first appeared on Easy Digital Downloads.

]]>
Below are questions related specifically to the
Frontend Submissions extension for Easy Digital Downloads.

Does Frontend Submissions work with PHP 7?

Yes, starting with FES version 2.4.

Why do my Vendor pages show a 404 error?

Typically this can be resolved by navigating to
Settings → Permalinks and click the Save Changes button. No changes need to be made; saving the existing settings will create the proper rewrites in most cases.

Also, make sure that there is a Vendor page set under
EDD FES → Settings → Forms/Pages.

Why do I get an error while trying to upload images?

There are a number of reasons why you may experience an error when trying to upload files through the media uploader. While not all displayed errors are detailed, we have compiled a list of possible reasons why you’ve encountered an error. Please check for the following:

  • Lack of permissions – Does the user have permission to upload files? Make sure vendor permissions have not been accidentally modified in this manner. WPBeginner has an article explaining what the necessary permissions are and how to set them.
  • Lack of memory – This is a general WordPress issue that occurs when you pass your default memory limit. To increase it, try placing define('WP_MEMORY_LIMIT', '64M'); in your wp-config.php file directly ABOVE the /* That's all, stop editing! Happy blogging. */ line.
  • Non-supported file extension – By default, WordPress only allows certain image, document, audio, and video file types. Make sure the attempted upload is of an allowed file type.
  • Upload folder permissions – Have you modified the permissions for any of your uploads directories?
  • Another plugin altering the save directory to one that isn’t supported – Check to see if you encounter the error with all other plugins deactivated except for EDD and FES.
  • Bad file name – Though rare, check your file name for abnormal characters like ' or similar.
  • PHP Version – Contact your host to see what version of PHP you’re running. You should be on at least version 5.6 for it to be compatible with WordPress.
  • Jetpack conflicts – Do you have upload errors after temporarily deactivating Jetpack? You can test by reactivating Jetpack, then toggling settings to see if an individual Jetpack module is causing the conflict.
  • Plugin that minifies the file on upload – If you have this functionality in place, try the upload process with the aforementioned functionality removed.
  • Blocking media-upload.php or admin-ajax.php – Be sure you do not have any .htaccess restrictions, caching, or security plugins/settings that block access to files necessary for the upload. Plugins, such as WP Admin No Show, that remove access to /wp-admin/ for non-administrators are frequent causes of this problem.

Note: There is a known conflict between the “User Avatars Plugin” and FES. If you experience an image upload error, check to see if you have that plugin activated. If so, deactivate it. If you do not have it activated, temporarily deactivate all other plugins besides EDD and FES then try once more.

Can vendors create new categories?

Yes. By using the “Category” field type in your submission form and setting the “type” option to “Text Input”, your vendors can create categories by entering comma-separated categories upon submission. For example, they could enter “Category 1, Category 2, Category 3” into that field and categories with those names will be created upon submission.

Can vendors access customer sales data?

From the automatically created Vendor Dashboard, Vendors can view their products as well as sales data for their products.

Can there be multiple submission forms?

FES only supports one submission form at this time.

Conditional logic for form fields?

FES does not currently support conditional logic for form fields. This means that the state of one field cannot depend on the current state of another.

Can I display submission form data on products page?

FES does not currently have a template tag system for easily displaying submission form data on product pages or other pages on your site. However, this is currently being developed and will be added in a future release.

Can I change the max upload file size limit for vendors?

The max file size for uploads cannot be set in FES specifically. FES uses the settings that all media uploaders in your WordPress install will use, which is based on your PHP settings. You can adjust your PHP settings to create a new max file size but that means it will apply to
all media uploaders and not just FES.

You’d use the following code (adjust as needed) in your php.ini file:

upload_max_filesize=128M

Can I limit the number of products a vendor can submit?

Yes, you can control the number of products a vendor can publish using Restrict Content Pro and the EDD FES Vendor Limits add-on.

Limiting the number of products a vendor can publish

At this time, Frontend Submissions doesn’t support this out of the box. However, you can do this using Restrict Content Pro and the free
EDD FES Vendor Limits add-on for Restrict Content Pro.

Google Maps Field Missing

Google Maps was removed in FES 2.1 due to compatibility issues.

Can I customize the Frontend Submissions templates?

Yes, Frontend Submissions uses the same
themeing methods that Easy Digital Downloads core uses.

Note: There are code snippets specific to Frontend Submissions that allow for even more customizations available here.

The post Frontend Submissions – Frequently Asked Questions first appeared on Easy Digital Downloads.

]]>
Frontend Submissions – Basic Setup https://easydigitaldownloads.com/docs/frontend-submissions-basic-setup/ Mon, 24 Jan 2022 19:53:27 +0000 https://edd-site.lndo.site/docs/frontend-submissions-basic-setup/ Table of Contents Main Settings Forms/Pages Permissions Emails Integrations Frontend Submissions (FES) is an extension for Easy Digital Downloads that allows you to create your own storefront for selling third party products. Once FES is configured, you may allow anyone you wish to sell digital products through your store. You can also: moderate vendors moderate uploads optionally

The post Frontend Submissions – Basic Setup first appeared on Easy Digital Downloads.

]]>
Table of Contents

Frontend Submissions (FES) is an extension for Easy Digital Downloads that allows you to create your own storefront for selling third party products.

Once FES is configured, you may allow anyone you wish to sell digital products through your store. You can also:

  • moderate vendors
  • moderate uploads
  • optionally track commissions (with an extension)
  • allow vendors to view orders
  • allow vendors to create/edit/delete products
  • give vendors access to their own product dashboard
  • and much more

Frontend Submissions Overview

After you have installed and activated the Frontend Submissions extension, you can find the settings area by navigating to EDD FES → Settings.

Main Settings

Rename Vendor: Add new text here if you’d like to change all references of “Vendor” to something else (ex: Shop Owner).

Rename Product: Add new text here if you’d to change all references of “Product” to something else (ex: Files).

Vendor Announcement: You can add text here specific to Vendors which will show on the Vendor Dashboard page.

Use FES’s CSS: You can disable styles added by Frontend Submissions if needed. Typically this would be done if there are styles already in place from your theme or if there are issues being caused by the FES CSS.

Forms/Pages

Vendor Dashboard Page – This is the page that acts as the central frontend dashboard for vendors. This page was automatically created when you activated Frontend Submissions. If you choose to change this page, please ensure that you update the select page here as well. This page must contain the [fes_vendor_dashboard] shortcode.

Vendor Page – This page is used as the base page for vendor stores. This page was created when you activated Frontend Submissions and will usually be left as is. This page must contain the [downloads] shortcode.

Enable Multiple Purchase Mode for all vendor products: Enable this option to allow customers to purchase multiple variations of a Vendor product simultaneously.

Show custom fields on the download: Enable this option if you want to select which fields to show on the product page using the radio buttons on the top of each field on the submission form builder.

Permissions

Registration: Enable this option to allow guests to apply to become a Vendor.

Applications: This option allows existing WordPress users to apply to become a Vendor.

Show the Admin Bar: This option allows the admin bar to be shown to logged in Vendors

Automatically Approve Vendors: This allows the Vendors to be automatically approved, opposed to being in moderation until the site owner approves them.

Automatically Approve Submissions: This allows Vendors to add products freely without having to wait on the site owner to approve submissions.

Automatically Approve Vendor Edits: This allows Vendors to edit their products without having to wait on the site owner to approve the change.

Allow Vendors to Create Products: This allows Vendors to create products.

Allow Vendors to Edit Products: This allows Vendors to edit products they’ve created.

Allow Vendors to Delete Products: This allows Vendors to delete products they’ve created.

Allow Vendors to View Orders: This allows Vendors to view the orders that have been made for their products.

Emails

Under the Emails section, you can configure each of the emails sent out for various events. Click here for a list of template tags available and sample emails.

Integrations

This area allows the integration with reCAPTCHA to allow it to be added to the login and contact forms for Vendors. You can read more here on how to configure reCATPCHA.

The next steps of the setup process include the Submission, Profile, and Registration forms for Vendors. You can read more about each form through the links below.

The post Frontend Submissions – Basic Setup first appeared on Easy Digital Downloads.

]]>
How can Frontend Submissions vendors manage their own support? https://easydigitaldownloads.com/docs/how-can-frontend-submissions-vendors-manage-their-own-support/ Mon, 24 Jan 2022 19:52:21 +0000 https://edd-site.lndo.site/docs/how-can-frontend-submissions-vendors-manage-their-own-support/ If you’re a site owner you don’t want to answer support requests for all of your vendors.  This document will show you how to make it so customers contact vendors directly. Step 1: Adding Comments Support to Downloads Adding comments support to downloads will make it so that customers can post questions directly on a

The post How can Frontend Submissions vendors manage their own support? first appeared on Easy Digital Downloads.

]]>
If you’re a site owner you don’t want to answer support requests for all of your vendors.  This document will show you how to make it so customers contact vendors directly.

Step 1: Adding Comments Support to Downloads

Adding comments support to downloads will make it so that customers can post questions directly on a product page. To learn how to do this,
read our documentation on adding comments support to downloads.

Step 2: Communicate With Your Vendors

Technologically Step 1 is all you need to do. Once comments are on however, you need to communicate with your vendors that they’re now responsible for paying attention to those comments and responding to them.

The post How can Frontend Submissions vendors manage their own support? first appeared on Easy Digital Downloads.

]]>