Professional Documents
Culture Documents
Directorybox Documentation 7124
Directorybox Documentation 7124
To begin with, first you need to have theme and recommended plugins installed and activated on your site.
WP-Directorybox Manager (our custom post type management plugin)
Directory Box Framework (necessary includes and functionality supports are included with this plugin)
CS Icons Manager (For the icons management)
Slider Revolution (for slider management)
Okay, Once you have installed these, then navigate to Directory / Import demo data in wordpress admin dashboard. To have demo
data as per live demo you need to ensure following configurations in your php.ini file.
upload_max_filesize * = min 128M
memory_limit * = min 256M
post_max_size * = min 128M (For large data websites, post_max_size needs to be increased as per need)
max_execution_time * above 300
allow_url_fopen * should be enabled in your php.ini file to help import demo data from other API server. (You can disable after
successful import!)
max_input_vars * above 5000
- cURL Support should be enabled in php.ini
- Zip should be enabled in php.ini
- Json Support should be enabled in php.ini
- XML Support should be enabled in php.ini
Note: Memory Unit must have to be “M” to get recognized by demo importer. !
3. Installing Demo
If these settings match your configurations in PHP.ini file, then you will see green tick marks which means all requirements are okay.
As these settings are already met, click on next step and you will see a screen asking you to put purchase code*
*You can find you purchase code from your theme forest dashboard > Downloads >DirectoryBox> purchase code. If you
already used your purchase code and giving error: “THE PURCHASE CODE IS BEING USED ON ANOTHER SITE. PLEASE
DEREGISTER IT FROM THERE AND THEN TRY AGAIN”. Than follow article to deregister and release your purchase code
here: http://chimpgroup.com/knowledgebase/how-to-de-register-purchase-code/
* Input your valid purchase code, after validation, you will see list of demos available to import. Select demo of your choice, lets
select default DirectoryBox demo and click on next.
You will see link of items to import. Let all of them checked and click on next.
A screen will appear showing demo data is being imported, it usually takes 1 minute to 5 minutes depending upon your server
settings and internet speed. For me, it gets imported in less then a minutes. Upon completion, you will see a success message saying
all demo has been imported.
How to Register/login via Member account?
This article will explain how to enable registration on DirectoryBox Theme. Here are simple instructions to do that
1- First, enable the membership option so that registration options should be visible on front-end from. You can do it here;
Dashboard/ Settings / General / Membership / Check anyone can register
Disable the Demo user by going to Admin dashboard/ WP DB / Settings / Advance settings / Demo user login -> OFF
2- Now, navigate to plugin settings to enable user login dashboard. You can do it here ;
Dashboard / WP DB / Settings / General options/ User login dashboard -> ON
Now click “Join Us” button from front-end to get registered on DirectoryBox site, SignUp email will be sent to you containing
password.
Directory theme provides the option to Enable/Disable the User Auto Approval for that navigate to
Dashboard / WP DB / Settings / Account settings / User Auto Approval
User Auto Approval: If this switch set to ON new user will be auto approved. If switch is set to OFF admin will have to approve the
new user.
If the user Auto Approval is OFF then admin have to activate the user account by going to Admin Dashboard / WP DB / Members
/Account settings/ profile status
SMTP settings in Directory box Theme
DirectoryBox theme brought the stunning feature of SMTP. You can configure your SMTP setting from your WP-admin dashboard.
After that email should have to receive via your Gmail account. All done!
How to add yelp places and nearby places on single detail page?
DirectoryBox theme provides the option to Enable/Disable the Yelp Places and nearby Places from the single detail page. Navig ate:
Dashboard / WP DB / Listing Types / Select Desire Listing Type / General Settings / Price
Options
Price Option for Listings: If set to “OFF” the listings in this type will not have the price options while adding / updating them.
Minimum Price on search filters: This will be the minimum option on the search filters for price.
Number of Price option: This will be the maximum number of price options on the search filters, You can add only maximum 50
intervals.
Min – Max Interval: This will be the interval for the minimum and maximum options on search filters. e.g( if you have entered the
interval as “50” the options will be like 1-50-100-150 …. ).
Search Style: Select the field style to show on frontend.
How to Configure Facebook Social API keys in Directory box Theme
How to create and configure Facebook API keys?
**Firstly make sure SSL is installed on your site (i.e Your site links should be like https://{Your website}). Don’t use any plugin to make your
site ssl secure. You may ask your hosting provider to install ssl on your site.
1. Login to Facebook Before creating a developer account, login in to your Facebook account.
2. Developer Account You’ll need Facebook developer account to get started. If you don’t have one, upgrade your personal Facebook
account to a Facebook Developer account now. Skip this step, if you already have a developer account.
3. Create new Facebook app Choose My Apps in the header navigation and select Add a New App.
4. Choose a Name Choose a name for your app and add your email
8. Follow “Quick Start” Steps The quick start wizard will help you to set up your Facebook app for the selected platform. You can come
back to the quick start wizard at a later time to either continue your setup or add a new platform to your app.
9. Navigate to “Settings” under Facebook login Add your site url and redirect url under “Valid OAuth Redirect URIs”(i.e https://{Your
website} & https://{Your website}/index.php?social-login=facebook-callback).
10. App ID Your app will have a unique app ID. You will use this ID whenever you use one of our SDKs or Open Graph tags for sharing.
You can find your app ID in your app’s dashboard.
11. Add Your Domain Add your app domain(i.esite url) , “privacy policy” and “terms and services” page url under “BASIC” settings. Also,
select a category for your app.
12. Allow API access Turn on api access to app settings.
12. Protect your App Secret Facebook auto-generates an app secret associated with your application. The application secret
authenticates requests made by your application to Facebook servers and should be treated like a password. Do not output your Facebook
application secret in your webpage markup; be careful when committing files containing this value into source control software such as a
public Git or Subversion repository.
13. Contact Email You need to add a contact email for each app. Go to your app’s dashboard and select the navigation item Settings in the
left sidebar and provide a valid contact email.
15.Disable Development Mode New Facebook apps exist in development mode by default. This limits published actions and related
objects such as friend tagging to Facebook Timelines owned by a developer of the application. Once your application is ready for public use
you can switch from development mode to public mode to allow your app to interact with Facebook accounts not associated with your app.
16.Add Your keys to Site After creating App, Add API keys in API settings and all done! WP DB/ Settings / API settings / Facebook
Directorybox Single Listing Options
Mortgage Calculator settings
Minimum Lease Year: Enter minimum lease year for mortgage calculator, which is to be shown in listing detail page, if in “Listing
Types” mortgage calculator switch is to be “ON”
Maximum Lease Year: Enter maximum lease year for mortgage calculator, which is to be shown in listing detail page, if in “Listing
Types” mortgage calculator switch is to be “ON”
Description: Please add text shows at bottom of the mortgage calculator.
DirectoryBox theme also provide the option to Enable/Disable the Mortgage calculator from the Listing detail page for that naviga te:
Dashboard / WP DB / Listing Types / Select the Listing Type /Listing Detail option
Directorybox API Settings
How to create and configure Twitter API keys
How to Generate Twitter API Key, Consumer Token, Access Key for Twitter OAuth?
To make things straight, you have to create a Twitter application to generate Twitter API Keys, Access Token and secret keys and so
on. To use Twitter counter widget and other Twitter related widgets, you need OAuth access keys. To get Twitter Access keys, you
need to create Twitter Application which is mandatory to access Twitter.
Enter your Application Name, Description and your website address. You can leave the callback URL empty.
Two codes obtained now lets Create Access Token for OAuth Click on KEYS and access tokens like following screenshot
Submit the form by clicking the Create your Twitter Application
Two codes obtained now lets Create Access Token for OAuth Click on KEYS and access tokens like following screenshot
And click on generate my access token. Like below screen! Copy following keys from above screen
Consumer key
Consumer secret
Access token
Access token secret
3. Click the “Add New Application” link and fill in the following required fields:
Company Info
1. Company – Choose to add an existing company or create a new company.
Application Info
1. Application Name – Enter your application name, usually your site’s name.
3. Application Logo
5. Website URL – Home page URL where the integration will go live. This should end in a / (ex:http://www.mysite.com/)
6. Business Email:
7. Business Phone:
you’ll need to be logged into a Google account. You’ll be asked to register your website, so give it a suitable name, then li st domains
(for example tutsplus.com) where this particular reCAPTCHA will be used. Subdomains (such as webdesign.tutsplus.com and
WP DB / Settings/API Settings / Yelp / Put your appID and secret key here / Save all Settings.
2. Click on the link , Now you will get your access token for your yelp API.
How to configure Walkscore API Settings for DirectoryBox Theme
DirectoryBox Theme comes with WalkScore feature. WalkScore is a number between 0 and 100 that measures the walkability of any
address. For each address, Walk Score analysis hundreds of walking routes to nearby amenities. Points are awarded based on th e
distance to amenities in each category. To enable Walk Score on your DirectoryBox listings following below steps: 1. Register for an
API from your Walkscore account here: https://www.walkscore.com/professional/api-sign-up.php
2. Get and copy Walk Score API Key at: Dashboard / WP DB / Settings / API settings / Walk Score API Key
3. Enable Walk Score on DirectoryBox listings from: Dashboard / WP DB / Listing Types / Listing Detail Options / Walk Scores
4. Once, You will add Walk Score API key, they will appear on DirectoryBox Listings detail page.
Dashboard / WP DB / Locations
To add Country: Dashboard >> WP DB >> Locations >> Add Location (No parent Location)
To add State: Dashboard >> WP DB >> Locations >> Add Location (Select country name as parent Location)
To add city: Dashboard >> WP DB >> Locations >> Add Location (Select state name as parent Location)
To add Town: Dashboard >> WP DB >> Locations >> Add Location (Select city name as parent Location)
2- Then,set the location levels. You can do it here;
Dashboard / WP DB / Settings / Location settings / Set Locations Levels &
Location’s Fields Selector
How to install Directory box Theme and plugins
Installing Directorybox Theme Via WordPress:
Make sure you have following server and php.ini configurations to install Theme and plugins. Server & php.ini requirements for
Directory box Theme
Follow the steps below to install the theme via WordPress:
Step 1 – Navigate to Appearance > Themes.
Step 2 – Click Install Themes and hit the upload button.
Step 3 – Find the “Directory box.zip” file on your computer and click “Install Now”
Step 4 – Once uploaded, activate the theme. Go to Appearance > Themes and activate it.
Step 5 – Then you will see a notification message to activate the required & recommended plugins. Follow the steps to install
and activate each plugin.
Attention Note! You can upload .zip files in this method of theme installation. No other format is accepted there, and, result will be
error in installation.
Step 5. Then click on “Connect” and cross your fingers that you have entered the correct information in the right boxes. If
you entered the information correctly it will connect with your server and populate the area on the right side of the program with
folders that shows your website files on the server, ( the left side of the screen displays and gives you access to your loca l folders on
your computer.
Step 6. One of the folders you see is your website main directory. Typically if your webhost uses a cPanel server, your main root
directory is called “public_html”.Your WordPress files should be in that file. The main WordPress files that a begin ner needs to
work with is in a folder called “wp-content”. This is the file where you will find you “Plugins” folder as well as your “Themes” folders.
Step 7. To get new plugins or themes added to your WordPress Install through FTP, download zipped files of plugins and or themes
to your computer. When downloaded, extract them to a file on your computer. Drag the unzipped plugin or theme files, individu ally
into either the plugin or the theme file as the case may be.
Step 8. Go to the WordPress dashboard and go to “Appearance”, “Themes” and see that your new theme now shows up in the list
of themes. The downloaded theme should be there. If not refresh, and it should appear ready to be activated. The same with Pl ugins.
The downloaded Plugin should be in the list of “Plugins”and then you must activate it and configure each one as necessary.
Attention! If you face any problem in uploading purchased theme, just navigate FAQ’s section to get appropriate solution if still
problem persists open a ticket and Chimp Studio team is there to help at Chimp Support.
Plugin Installation
With the activation of Directory box Theme Help guide theme, you are prompted with admin notices that certain plugins are required
for the theme. Following plugins are need to be activated for Directory box theme to work properly.
1. WP-Directorybox Manager (Required)
5. Contact From 7 (Optional) This theme have custom contact form. For extended contact forms, activate this plugin.
6. Envato WordPress Toolkit (Optional) view your ThemeForest purchases within the WordPress dashboard and quickly update your
theme without losing any data & settings of theme.
Dashboard >> Wp DB >> settings >> Assign listing submission Page and Price
Plan Page
How to post listing from frontend
This article will explain how to post listing from frontend on DirectoryBox Theme. Here are simple instructions to do that
1- First, Login from a DirectoryBox Member account and click on Add Listing button
2- Then,Select the package you want to post lisitng
3- Add all the information and click save and preview
How to add Listing types and categories
This article will explain how to add Listing types and categories on DirectoryBox Theme. Here are simple instructions to do that
1- Firstly, add the categories you want. You can do it here;
2- Now, edit that page builder element and Set “Map Position” to right and “Listing Types” to “All Types”
How Autocomplete and Location Search works in Directory box
Theme
This article will explain how Autocomplete and Location Search works in Directory box Theme.
1- Firstly, make sure you have added google maps api keys on your site. Please visit your Dashboard and add google API key at following
location;
Checkout Page
Choose configured woocommerce payment gateway and click ‘Place Order’ button to pay and all Done!
Say ‘Yes’ if its helpful!
Important Note ! No firewall or strict permissions/cache on server to avoid any kind of hindrance.
Press ‘Yes’ if article is helpful!
Theme Update & Backup Guide
Best Practice To update your theme to latest version follow given simple steps:
1. Maintain the Complete backup of your site and database before theme update in order to avoid any potential data loss.
2. Go to theme forest download dashboard, select “Download all Files“, get the latest updated files.
3. Deactivate the previous theme version from WordPress Dashboard > Appearance > Themes > Deactivate Theme
4. Upload Latest updated theme version on your site via FTP or WordPress dashboard as feel comfortable.
Note: Make sure you have sufficient backup of website and database with you. Thank you!
How to add currencies in Directory box Theme
DirectoryBox theme provide the option to add currency option as per your desire.You may set any currency you wish for your di rectory portal
website.currency can be set through theme option for whole website.
Navigate to : Dashboard / WP DB / settings / Currencies.
Currency switch:Directory box have currency switch option you may switch currency as per your desire .For this You can turn ON/OFF the
currency switcher to change the currency.
Currency name:From here you have to define the currencies you want add while switching the currency.
Base currency: There will only one currency that you will select from the currency list.
Currency position:You can set the currency position as per your desire.
Save settings!
All done.
Save all settings, your selected sidebar widgets will show on listing detail page. All done!
How to Claim and flag listing
Administrator can moderate Claim/flags from and can set the status after reviewing the claim against each listing from : Dashboard / WP DB /
Claims/Flags
Claim:Claim is report the admin about some obnoxious behavior about the ad or some thing which is promised but not facilitated.
Flag: Flag listing feature purpose is the removal request for inappropriate content.
How to contact Listing’s Organizer
In DIRECTORYBOX theme User can contact to the listing’s organizers through their listing detail page.
Navigate to listing details page.There will be a contact form in the listing detail page side bar.User can manually co ntact to the list organizer.
By viewing the listing organizer’s profile user can directly contact to the listing organizer through phone call.
How to Customize Single listing page
Directorybox listing is among one of the main feature of Directorybox theme. you can customize single listing page of your site from here.
follow the path: Dashboard / Listings / Edit listing.
navigate to the bottom of the page where you see Listings options.
Listing type: Select the listing type to be assigned to relative listing
Visibility: Select the visibility for your ad here. If you set it to “Private”, listing will not be visible on frontend.
Listing sold: If you set it to “yes” listing will be shown along with the listing on frontend.
Select Member: Select the Company with which you want to associate listing
Select User: Select the User of the company with which you want to associate listing.
How to import Bulk locations
Directorybox theme comes with the feature to add bulk locations to your listing. You can add locations to your site by navigating to:
Locations CSV file format must contain following column fields with correct/valid information as requested.
1. Name
2. Parent
3. ISO code (ISO Code stands for (International Standard Organization). You can add Whatever your country ISO code is, or you can find it from
the following link : https://countrycode.org/)
4. Area Coordinates
5. Zoom level
How to enable Social Auto posting in Directory box Theme
Navigate to : WP DB / Settings / Social auto poster / Turn ON the social buttons.
Save settings.
All done!
post_max_size = min 128M (For large data websites, post_max_size needs to be increased as per need.)
safe_mode=off
allow_url_fopen= on
Admin can moderate listings from back-end by going to .Dashboard / Listings / Edit listing.
navigate to the bottom of the page where you see Listings options.
Listing Default Status:
Admin can be set listing default status with out admin approval.
Turn this switcher OFF to allow direct publishing of submitted listings by member without review / moderation. If this switch is ON, listings will
be published after admin review / moderation.
Dashboard / WP DB / Settings /General Options.Listing default status.
Click ‘Page Builder’ to show page builder section to choose elements from :
Click ‘Add Page Section’ link to open dialog box containing rich Directory box elements and choose what you need :
Now click on ‘Add Element’ to open dialog box containing directory box page builder elements:
Directory box Shortcodes
Now click on “Classic Editor” button to get short codes of page builder elements:
Directory box Theme Demos Import
This article will explain how you can Import Directory box Theme Demos . Navigate to :
Dashboard / Directory / Import demo data /
Confirm Plugin Requirements & Server Requirements / Next step
Purchase code Validation
Add Your Envato Provided Purchase code and Envato Provided Email Address / Next Step
Choose Demo
Select the demo you want to import and click Next Step
Choose Items to Import