Installing the Theme

After downloading the installable WordPress file from ThemeForest, you can install the theme in a couple of ways.

Install via WordPress

  1. Log in to your WordPress admin area
  2. Browse to "Appearance > Themes"
  3. Click on "Add New"
  4. Click "Upload"
  5. Browse and select the theme zip file to upload

Install via FTP

  1. Connect to your server through FTP, by using an FTP client like FileZilla.
  2. Find the WordPress installation folder.
  3. Browse to the "/wp-content/themes/" folder.
  4. Upload the theme files there.
    Note: Theme should already be extracted from the zip file before uploading.
  5. Login to your WordPress admin area to activate the theme.

Check out the guide on WordPress.org for more information.

Configuring Automatic Updates

To use automatic updates in your site, you can use the offical Envato plugin which you can download from here:

Download WP Envato Market


Watch the video tutorial below on how to install and configure WP Envato Market plugin



Getting Started

You can get the most out of MyListing theme by installing the provided addons, and importing demo content.

Installing Included Plugins

Included plugins are required to setup the directory listings, add listing products, create promotions, and other site functionality. Installing them is required in case you intend to use all the advertised features.

Once you activate the theme, a message in the admin panel will ask you to install the included plugins (see photo below).


Click on 'Begin installing plugins', and you'll be redirected to a page where you can bulk install all the plugins at once. This message will also popup from time to time, asking you to update the plugins to the latest version.

Importing Demo Content

A great way to setup your directory site is to get a replica of the demo, then edit it until it matches your requirements.

You can easily grab any of the demos, by following these steps:

  1. Install All-in-One WP Migration plugin
  2. Navigate to "All-in-One WP Migraton > Import" in the admin menu
  3. Choose the "Import from file" option, and select one of the demo files present in the theme package (e.g. mycity.wpress).
  4. Proceed with the import. Once it's completed, navigate to "Settings > Permalinks". At this point, it will log you out automatically, but you can log back in using username: admin and password: admin
  5. Navigate to "Settings > Permalinks" and click on "Save Changes". Do this twice.
  6. Go to "Elementor > Tools" in the admin menu, and click on "Regenerate Files" button.
  7. Go to "Users > Your Profile" and change the password from "admin" to something secure.
  8. That's it.

VIDEO: Importing "MyCity" demo in just a couple of minutes.



Configure

Theme Options

Theme Options can be found under "Theme Tools > Theme Options" page in the admin menu. Here you can set the site logo, brand color, edit the header appearance, enable/disable features like loading overlay, smooth scrolling, etc.


Setup Pages

You can add new pages by going to "Pages > Add New". Besides building pages using Elementor, MyListing also provides a few ready to use page templates. You can set the template using the "Template" dropdown in the "Page Attributes" box.

Set the home and blog pages by following these steps:

  1. Navigate to "Settings > Reading"
  2. Set the "Front page displays" option to "A static page"
    • Homepage: Click the "Front Page" dropdown and select your page.
    • Blog: Click the "Posts page" dropdown and select your page.

Elementor Page Builder

MyListing uses the Elementor Page Builder. It is an easy to use, powerful front-end drag & drop page builder. To use it, simply create a new page, and click on the "Edit with Elementor" button.

Including 20+ custom widgets provided by MyListing theme, you have 50 page builder elements to choose from, to build your site.

You can read more about Elementor on the official documentation here.

Page Settings

On the "Edit with Elementor" page, under the "Page Settings" option, MyListing theme adds some global options to customize/hide the page header, title bar, and footer. This can come in handy in case you want to have a blank page to add elements upon, or if you need to hide any of these three "default" elements.

Listings

Foreword

MyListing theme takes a different approach to adding directory listings. Unlike most other solutions out there, that provide a set of listing options, have a predefined number of listing fields, and can't be customized far from their demo - MyListing gives the user control to every aspect of how a listing works.

It introduces a new concept, called "Listing Types". You can create multiple listing types in a single site, which can be really useful in case your listings can be for totally different purposes, say one for Places and another for Events.

What level of customization do listing types provide?

  • Manage fields (Add/Edit/Reorder/Remove).
  • Customize the single listing page layout uniquely.
  • Create basic & advanced search forms, with unique search facets.
  • Customize the listing preview template.
  • All the customizations are done through the admin panel. Child themes or custom code not necessary.

Create a Listing Type

To create a listing type, navigate to "Theme Options > Listing Types" and click on "Add New". Enter the listing type's name, which should describe what this type will be used for.

Click on "Publish", and continue customizing the listing type through the interactive metabox.

Fields Tab

The first tab on the interactive listing type builder, is the fields tab. You can interact with the fields using drag & drop, or by clicking the helper buttons. To edit a field, simply click on it - it will expand and show a list of options.


You can also add custom fields. They can be of many different types, and are hugely useful when a listing type has custom attributes that need to be filled.


Single Page Tab

The second tab allows you to customize the single listing page layout, cover buttons, tabs, and content blocks.


The single listing page features action buttons & informational content in the cover. These can be edited in the "Cover Buttons" sub tab. You can set the label for each button, the button style, and even display custom fields.


You can also manage the single page tabs, reorder them, and set what content appears in each of them.


Results Template Tab

This tab allows you to control the way the listing appears in search results, in the explore page, and wherever there's a listing feed widget.


The main components of the template are

  • The info buttons on the top left corner
    • One or more buttons can be added
    • You can choose to display any of the textual fields added in the fields tab
    • Buttons can be reordered with drag & drop
  • The info text below the title
    • One or more fields can be added
    • You can choose to display any of the textual fields added in the fields tab
    • Fields can be reordered with drag & drop
  • The footer sections
    • You can add one or more footer sections, and reorder with drag & drop
    • You can display listing categories, a related listing, listing details, and action buttons (Bookmark & Quick View).
  • There are also two different templates for the way the title, and the listing logo are displayed.


Settings Tab

This tab allows you to set an icon for this listing type, as well as define the singular and plural names of it. You can also generate an export file with all the listing type configuration. Likewise, you can import a configuration file to the current listing type.

Ready to use Listing Configurations

This list is exported directly from our demo sites. Simply download and import them in the settings tab of your listing type.

Listings

Add Listing Form

The "Add a Listing" form is a page that will handle the process of selecting the listing type, filling the listing fields, and submitting it.

Create a new page, and click on "Edit with Elementor". Once the Elementor page builder is loaded, go to the widgets list, and select the "27 > Add Listing Form". You'll see that the widget has a few options to configure, most importantly, the "Listing Types" option. Select the listing types, reorder them, and click on "Save". The final page should look like this:



Once you click on one of the listing types, a form with the listing type's fields will be shown.


You can also link the Header "Call to Action" button to this page, using the "Theme Options > Header > Call to Action links to page" option.

Explore Listings

Follow these steps to create an Explore page:

  1. Create a new page, and click on "Edit with Elementor".
  2. Go to "Widgets" and select the "27 > Explore Listings" widget.
  3. Configure the template, map skin, listing types, and categories to be shown.
  4. (Optional) Go to Elementor "Page Settings", and hide the title bar and the footer. This way, you'll get the full height explore page, as shown in the demos.

Setup Promoted Listings

To enable promoted listings, go to "Theme Tools > Promotions", and check the "Enable Promotions" option. After that, you can add promotion packages, which require two parameters: the number of promotion days, and the price.


Once you save the promotion settings, a new WooCommerce product will be created, named "Promotional Key". Users can buy multiple promotional keys. They can be accessed through the user menu, under "Promotions" section. A key can be used for one listing. It can, however, be cancelled and the remaining promotion time can be applied to another listing. A key can be applied to any of the user's active listings. To promote multiple listings, the user would have to buy multiple keys.


Listing Products

MyListing provides a way for registered users to publish their own products. They can do this by navigating to the user menu, and selecting "My Products" page. There you will find listed the published user products, those that are still being reviewed, and a button to add new products.

MyListing is also compatible with WC Vendors plugin, which apart from allowing the user to add any type of product, the site admin can also take a commission fee on each product sale, and the payment to the user will be done automatically.


Users can then assign those published products to their listings, and will be visible on the listing single page. This will be possible in case the listing type supports adding products and has a products tab configured by the site owner, so it's entirely optional.

In the example below, a 'Tickets' tab has been added (using the listing type builder). The user then created a 'Ticket' product, and assigned it to this listing.


Shortcodes

MyListing comes with custom shortcodes, and a straightforward shortcode builder. These will make it easier to add icons, buttons, format text, and other stuff throughout the site.


Language & Translations

MyListing is fully localized and translation ready. It works with all the main WordPress translation plugins, like:

You can also manually translate the included "my-listing.pot" file, using an editor like Poedit.

Have a Question? Open a ticket in our Helpdesk.