Installation

Follow the steps below to complete the installation of Directories Pro.

Check installation requirements

The followings are required of your server (or your website) to install Directories Pro:

  • PHP 5.4.0 or greater
  • MySQL 5.0.3 or greater
  • WordPress 5.1.0 or greater

Once your server has been confirmed to meet all the requirements above, proceed to the next step to download and install Directories Pro.

Download package

Directories Pro can be downloaded from https://codecanyon.net/downloads/. Note that you will need to login with a CodeCanyon (or Envato) account in order to have access to the download page. Once you are on the page, scroll down to where it says Directories Pro for WordPress and then click the green Download button on the right and then the All files and documentation dropdown link. Your browser should start downloading the file instantly.

Locate the file downloaded on your computer (the name of the file is codecanyon-xxxxxxxx-directories-pro-for-wordpress.zip), and double click the file to unzip (unarchive) the package. You should then see a folder named DirectoriesPro-x.x.x (where x.x.x represents the version number) created containing the following files:

  • directories-x.x.x.zip
  • directories-pro-x.x.x.zip
  • directories-frontend-x.x.x.zip
  • directories-payments-x.x.x.zip
  • directories-reviews-x.x.x.zip
  • directories-faker-x.x.x.zip

As you can see, Directories Pro consists of 6 plugins that you will install and activate on your site in the next step.

Install and activate plugins

Now that you have the plugin files in hand, follow the steps below to install and activate them on your site.

IMPORTANT: It is extremely important to first install and activate the Directories plugin, and then other plugins after that as instructed in the steps below.

  1. Login to your website if not yet logged in and go to the WordPress administration dashboard.

  2. Select Plugins -> Add New from the side menu.

  3. Click the Upload Plugin link at the top of the page.

  4. Click Browse... and then locate the directories-x.x.x.zip file on your computer.

  5. Click the Install Now button.

  6. Wait until the page refreshes, and the click the Activate Plugin link.

    If the installation is successful, you will be redirected to the Plugins page and should be able to see the Directories plugin highlighted in blue, which means the plugin is installed and currently active.

  7. Repeat steps 2-6 for directories-pro-x.x.x.zip (Directories Pro plugin).

  8. Repeat steps 2-6 for directories-frontend-x.x.x.zip (Directories - Frontend plugin), directories-reviews-x.x.x.zip (Directories - Reviews plugin), and directories-payments-x.x.x.zip (Directories - Payments plugin). Although these plugins are optional, we do recommend installing and activating them all if you are unsure. You can use the bulk activation feature to activate all these plugins at once.

Register your license key (purchase code)

In order to protect valid purchasers of the plugin, some parts of Directories Pro are deactivated or inaccessible until your site is validated with a license key. If you currently do not have your license key in hand, make sure to download one from https://codecanyon.net/downloads/. If you cannot find your purchase code, please see https://help.market.envato.com/hc/en-us/articles/202822600-Where-Is-My-Purchase-Code-.

Once you have obtained your license key, follow the steps below to validate your site.

  1. Login to your website if not yet logged in and go to the WordPress administration dashboard.

  2. Click Directories in the admin sidebar.

  3. Click the Settings tab and then the System sub-tab.

  4. Copy and paste your purchase code to all the text input fields displayed under the License Keys section.

  5. Click Save Changes at the bottom of the popup window.

Configure map libraries

If you are going to use any of the map features, you will also need to configure map libraries used in Directories Pro.

  1. Login to your website if not yet logged in and go to the WordPress administration dashboard.

  2. Click Directories in the admin sidebar.

  3. Click the Settings tab and then the Map sub-tab.

  4. Scroll down to Map API Settings and configure the following:

    • Map provider - Select the provider of map tiles used to render maps. This is required to display or locate listings on a map, and any additional features of the API (Geocoding, Time Zone, Autocomplete, etc.).

      • Google Maps - free for mobile, partially free for web, requires Google Maps API browser key.

      • OpenStreetMap - free.

    • Geocoding API - Select a geocoding service provider to enable geocoding and reverse geocoding of addresses. Geocoding lets users search your directory by arbitrary location address. Reverse geocoding is used to find an address of a location when the map in the add listing form is clicked, and then auto-fill the address form field.

      • Google Maps Geocoding - partially free, requires Google Maps API browser and server keys, very reliable.

      • OpenStreetMap Nominatim - free, not very reliable.

      • Mapbox Geocoding - free up to 50,000 requests per month, then $0.50 per 1,000 requests, requires Mapbox access token.

    • Time zone API - Select a time zone API used to fetch the time zone ID of a location, which is used to determine whether or not the business listing is currently open at its location. The time zone configured in WordPress settings will be used if none selected.

      • Google Maps Time Zone - partially free, requires Google Maps API browser and server keys.

      • GeoNames Web Service Timezone - free, requires GeoNames user name and their free web services enabled.

    • Address autocomplete service - Adds an autocomplete (or autosuggest) feature to the location search field of the directory search form and Location type fields (full address field only).

      • Google Maps Place Autocomplete - partially free, requires Google Maps API browser key.

      • Algolia Places Autocomplete - free up to 100,000 requests per month, then $0.40 per 1,000 requests, requires Algolia application ID and API key.

Obtaining a Google Maps API key

Note: You can skip this section if you have not enabled any of Google Maps API services.

  1. Create an API project

    1. Make sure that you already have a valid account from Google and then go to Google API Console. If you are not logged into Google, you will be prompted to login first.

    2. On the Dashboard page of Google API Console, create a new project or select an existing project.

    3. Click +ENABLE APIS AND SERVICES and enable the following APIs found under the Maps category:

      • Maps JavaScript API - required if Map provider is Google Maps.

      • Geocoding API - required if Geocoding API is Google Maps Geocoding.

      • Time Zone API - required if Time zone API is Google Maps Time Zone.

      • Places API - required if Address autocomplete service is Google Maps Places Autocomplete.

      • Maps Static API - required if you wish to show a static map image of a location without requiring JavaScript or any dynamic page loading.

  2. Generate a browser key

    A browser key is required to use Maps JavaScript API, Time Zone API, or Places API with Directories Pro.

    Follow the steps below to create a browser key for Google Maps API:

    1. On the Credentials page, click the Create credentials dropdown button and click API key.

    2. On the API key created popup, click RESTRICT KEY.

    3. Under Key restrictions -> Application restrictions, select HTTP referrers (web sites) and enter the URL of your site. For example, if the URL of your site is https://www.example.com/, enter *.example.com/*. If the URL of your site does not have the subdomain part (for example https://example.com/), enter example.com/*.

    4. Scroll down and click Save.

  3. Generate a server key

    A server key is required to use Geocoding API or Time Zone API with Directories Pro.

    Follow the steps below to create a server key for Google Maps API:

    1. On the Credentials page, click the Create credentials dropdown button and click API key.

    2. On the API key created popup, click RESTRICT KEY.

    3. Under Key restrictions -> Application restrictions, select IP addresses and enter the IP address of your server.

    4. Scroll down and click Save.

  4. Enable billing

    As of July 16, 2018, Google requires you to enable billing for each of your API projects in order to use their Google Maps APIs. To enable billing, click the following link to Google Cloud Platform and follow the instructions displayed. https://console.cloud.google.com/projectselector/billing/enable

results matching ""

    No results matching ""