The Listdom Frontend dashboard let the site users to submit listings without accessing the WordPress admin dashboard. Additionally, it’s possible to manage the subscriptions, bookings, and applications of listings in the frontend dashboard.
👉 The frontend dashboard is available in the Listdom Pro Add-on.
After you create the dashboard, you can configure its details which are explained in this article. To configure these settings, head over to Listdom → Settings → General → Frontend Submission.
The available options on this page are:
1. Configuration
Page
Put the frontend dashboard shortcode [Listdom-dashboard] on the desired WordPress page (or any other allowed post type) and select that page here.
Locations
Choose the Locations box to be a checkbox field or a dropdown field in the “Add Listing” form.
Features
Choose the Features box to be a checkbox field or a dropdown field in the “Add Listing” form.
Gallery Method
There are two ways to upload the images as the listing gallery. The WordPress Media and the Simple Uploader. The WordPress Media mode shows up a window like the default WordPress media manager. The user can select from other images on the site or upload new ones. The Simple Uploader mode simply opens the user’s device file manager to select and upload the images.
2. Guest Submission
Guest Submission option, lets the site user submit listings as a guest and not a registered user.
Status
When this option is disabled the frontend dashboard shows a message to the non-logged-in users and asks to log in.
While the option is enabled, The user can see the dashboard and submit a listing. Obviously, in this state, the logout menu item is not displayed since the user is not logged in. Since the listings must be reviewed by the site admins, a “To Reviewers” form will be added at the end of the “Add Listing” page. The listing submitter must fill out the form with their Email address and a message to the reviewers about the listing.
Based on the “User Registration” method, the “To Reviewers” form has 3 statuses which we will discuss further.
The listings will be in the pending status and need to be approved by the site reviewers. The reviewers can see the submitted pending listings in the Listings → All Listings.
The “To Reviewers” form will be displayed to the reviewers in the Details section of the selected listing. To approve a listing. the reviewer must publish it.
User Registration
Determine how a new user must be registered to the site after the listing submission. The available options are:
- Once Approved: The user will be registered to the site once their listing is approved by the site reviewers. The “To Reviewers” form in this status includes these fields:
- Full Name
- Message
- Once Submitted: The user will be registered to the site once they submit the listing and even before the listing is approved by the site reviewers. The “To Reviewers” form in this status includes these fields:
- Full Name
- Password
- Message
- Disabled: The user won’t be registered on the site. The “To Reviewers” form in this status includes these fields:
- Message
The Email and Password fields are required wherever they exist.
The Best User Role For Using Listdom
By installing Listdom, two new user roles called “Listdom Author” and “Listdom Publisher” will be added to the WordPress user roles. The listings of the user with the Listdom Publisher role will be published automatically but the Listsom Author listings will be in pending status unless the site admin publishes them. You can set these roles to be the new default user role in Setting → General → New User Default Role. Users with these roles can have access to the frontend submission without having access to the WordPress dashboard.
3. Required Fields
Select the required fields for the “Add Listing” on the frontend dashboard. The user must fill out the selected fields to be able to submit a listing. Some of the fields are permanently mandatory since they are required for a listing to work properly:
- Listing Title
- Category
- Guest Email
- Guest Password
4. Restrictions
Apply some restrictions to the “Add Listing” form elements. The available options are:
- Maximum Gallery Images: Set the Maximum allowed number of images that the user can upload to a listing.
- Maximum Description Length: Determine the maximum number of characters allowed to be written in the listing description field.
- Maximum Number of Tags: Enter a number so that the number of listing allowed tags will be limited to that.
If the user enters more content than the allowed numbers, then an error message will be displayed:
5. Modules
Select which items can be shown in the frontend Add Listing form. You can enable elements or options in the add listing form for all of the users that have access to the Add Listing form. Also, you can change the access level and restrict it to site admin and editor roles. The third option for each element is to disable them. The listing title, category, description, and claim addon cannot be disabled. Also, some add-on elements don’t have a field on the Add Listing form so there is no option for them here e.g. Reviews add-on’s discussion element.
