onokazu

onokazu supports this item

Supported

Popular questions for this item

What are the system requirements?

  • PHP 5.2 or greater (with mbstring and curl extensions, and at least 128M memory_limit)
  • MySQL 5.0.3 or greater
  • WordPress 3.4 or greater
  • WordPress permalink URL structure must be something other than Default

How can I install the plugin?

Please read the Installation section of the documentation included in the package.

How can I update the plugin?

Please read the Update SabaiDirectory section of the documentation included in the package.

Can I install the plugin on WordPress Multisite?

Yes, WordPress Multisite is supported but do not network activate the plugin. Instead, you will need to activate the plugin from the plugin administration page of each site.

Also please note that if you are going to use the plugin on multiple sites, you will need to purchase one license for each site.

I have a redirection loop after install.

Something did not go right during activation of the plugin. Have you gotten any error message during activation?

If you have phpMyAdmin installed on your server, please issue the following SQL in phpMyAdmin and obtain the installation log for the plugin.

SELECT option_value FROM `wp_options` WHERE option_name = 'sabai_sabai_install_log'

Make sure to change the wp_ part if your database tables have a different prefix.

Also there could be a problem if the memory_limit setting of PHP on your server is set to a low value. Make sure the value of the setting is set to at least 128M.

If you are still having issues with the install or can not obtain any installation log, please contact support using the contact form on my profile page (http://codecanyon.net/user/onokazu) so that we can send you a database dump file that you can import from phpMyAdmin to manually setup the plugin.

How can I translate the plugin into my language?

Translatable files are in the Gettext format, which is the standard format used in WordPress. There are 4 Gettext POT (.pot) files:

  • wp-content/plugins/sabai/languages/sabai.pot
  • wp-content/plugins/sabai-directory/languages/sabai-directory.pot
  • wp-content/plugins/sabai-googlemaps/languages/sabai-googlemaps.pot
  • wp-content/plugins/sabai-paidlistings/languages/sabai-paidlistings.pot

Translate these files using a software like POEdit (recommended) and save the generated MO (.mo) files under wp-content/languages/plugins (or under WP_LANG_DIR/plugins if this is defined in your wp-config.php). Make sure that you append the lang code (check the WPLANG settings in wp-config.php) of your language to the file names. For example, if you are translating sabai.pot into French, save the generated MO file as sabai-fr_FR.mo.

Also note that some phrases like the form labels are not translated unless you had your language files ready before activating the plugin. The reason is that they can be edited from Directory -> Listings (or Reviews, Leads) -> Fields -> Manage Form.

IMPORTANT!
As of WordPress 4.0, WPLANG setting in wp-config.php is no longer needed. However, after placing your .mo file, you will need to select your language from Settings -> General -> Site Language.

Help, I have a blank page!

Please enable the debug mode of WordPress and see if any error message appears.

To enable the debug mode, change the following line in wp-config.php:

define('WP_DEBUG', false);

to

define('WP_DEBUG', true);
define('WP_DEBUG_DISPLAY', true);

Make sure to add the lines above to wp-config.php where it says:

/* That's all, stop editing! Happy blogging. */

Are there any shortcodes?

Currently there are 12 shortcodes available.

  • [sabai-directory]
  • [sabai-directory-listings]
  • [sabai-directory-map]
  • [sabai-directory-categories]
  • [sabai-directory-reviews]
  • [sabai-directory-photos]
  • [sabai-directory-listing]
  • [sabai-directory-slider]
  • [sabai-directory-photo-slider]
  • [sabai-directory-search-form]
  • [sabai-directory-add-listing-form] – Removed from version 1.3
  • [sabai-directory-add-listing-button]
  • [sabai-directory-pricing-table]

Please visit the page below for details and examples.

http://demo.sabaiapps.com/sabaidirectory/shortcodes/

Are there any widgets?

Currently there are 11 widgets included with the plugin:

  • Recent Listings
  • Recent Listing Reviews
  • Recent Listing Photos
  • Featured Listings
  • Related Listings
  • Nearby Listings
  • Listing Categories
  • Add Listing Button
  • Listing Map
  • Listing Photos
  • Contact Listing

Are there email notifications?

Yes, there are 24 email notifications all configurable from the administration dashboard. Here is the list of all email notifications:

  • Listing Submitted Admin Notification Email – sent to administrators whenever a listing that requires approval is submitted.
  • Review Submitted Admin Notification Email – sent to administrators whenever a review that requires approval is submitted.
  • Photo Submitted Admin Notification Email – sent to administrators whenever a photo that requires approval is submitted.
  • Lead Submitted Admin Notification Email – sent to administrators whenever a lead that requires approval is submitted.
  • Listing Approved Notification Email – sent to the user when a listing the user has submitted is approved.
  • Review Approved Notification Email – sent to the user when a review the user has submitted is approved.
  • Photo Approved Notification Email – sent to the user when a photo the user has submitted is approved.
  • Comment Posted Notification Email – sent to the review author when a comment is submitted.
  • Comment Posted Notification Email (photo) – sent to the photo author when a comment is submitted.
  • Review Added Notification Email – sent to the listing owner when a review is posted.
  • Photo Added Notification Email – sent to the listing owner when photos are added to the listing.
  • Lead Added Notification Email – sent to the listing owner when a lead is submitted.
  • Listing Claim Expiration Notification Email – sent to the listing owner from 7 days before expiration of a claim until the claim expires.
  • Listing Claim Expired Notification Email – sent to the listing owner after a claim has expired.
  • Listing Published Notification Email – sent to users of selected roles whenever a listing is published.
  • Review Published Notification Email – sent to users of selected roles whenever a review is published.
  • Photo Published Notification Email – sent to users of selected roles whenever a photo is published.
  • Listing Flagged Notification Email – sent to users of selected roles whenever a listing is flagged.
  • Review Flagged Notification Email – sent to users of selected roles whenever a review is flagged.
  • Photo Flagged Notification Email – sent to users of selected roles whenever a photo is flagged.
  • Listing Claim Approved Notification Email – sent to the user when a claim the user has submitted is approved.
  • Listing Claim Rejected Notification Email – sent to the user when a claim the user has submitted is rejected.
  • Listing Claim Pending Admin Notification Email – sent to administrators whenever a listing claim is submitted for admin review.
  • Order Received Notification Email – sent to the user when a user places an order.
  • Order Complete Notification Email – sent to the user when an order is complete.
  • Order Received Admin Notification Email – sent to administrators when a user place an order and payment received.
  • Order Awaiting Fullfillment Admin Notification Email – sent to administrators when ordered items for an order are ready for delivery.

How can I customize the display?

SabaiDirectory includes template files that you can modify to customize the output. The template files are located under the following directory:

wp-content/plugins/sabai-directory/assets/templates

You can copy these files over to wp-content/sabai/assets (or wp-content/themes/[Your Theme]/sabai for versions older than 1.2.25) directory (you must create this directory) and modify however you like. Note that you do not need to copy all the template files over to the folder, but only those you want to make changes. Also if the directory you are trying to customize the display is a cloned directory, you can optionally create a folder at wp-content/sabai/assets/[Cloned Addon Name] (or wp-content/themes/[Your Theme]/sabai/[Cloned Addon Name] for version older than 1.2.25) and copy the template files to the folder so that the modifications are applied to the cloned directory only.

In addition to copying the template files, if you place a stylesheet file at wp-content/sabai/assets/style.css (or wp-content/themes/[Your Theme]/sabai/style.css for versions older than 1.2.25), this file will be read after all the SabaiDirectory stylesheets are included. So use this file if you need to ensure that your custom styles are applied after the styles defined by the SabaiDirectory core.

How can I add custom fields?

From the admin dashboard, go to Directory -> Listings and click on the Fields tab. There you will see a form editor with default fields on the main section and a small panel containing buttons to create new fields on the right. Simply click on the button of the field type you would like to create and fill out the form that will be displayed in a modal window. Submit the form in the window and you’ll see the field added to the bottom of the form editor section.

Currently there are 18 field types available:
CAPTCHA, Choice, Date, File, HTML, HTML Text, Image, Link, Location, Number, ON/OFF, Paragraph Text, Range, Section Break, Single Line Text, Social Accounts, Time, and User

How can I display custom fields?

Custom fields can be configured to be displayed in several locations of the plugin. By default, there are 4 locations:

- Single listing page (Detailed view)
- Each listing on the directory index page (Summary view)
- Each listing in grid column on the directory index page (Grid view)
- Popup window on the map (Map view)

If you have custom single listing page tabs added from Directory -> Settings -> General -> Single listing page tabs, you can configure custom fields to be displayed in those tabs as well.

To display the fields in the above locations, please follow these steps:

1. Go to Directory -> Listings -> Fields -> Manage Form
2. Hover over to your custom field on the form preview. When you hover over each field, one or more icons will appear at the top right corner of the field.
3. Click the icon with a gear image which will open up a form in a popup window.
4. Scroll down to the section labeled Display Settings (Detailed view).
5. Check the Display this field option. This tells the plugin to display the field on the single listing page.
6. Optionally, configure settings displayed below in that section, such as Field render and etc., if any.
7. Optionally, repeat steps 5-6 for sections titled Display Settings (Summary view), Display Settings (Grid view), and Display Settings (Map view). This will tell the plugin to display the field on the directory index page and in the popup window on the map respectively.
8. Optionally, if you have custom single listing page tabs, repeat steps 5-6 for sections titled Display Settings (Tab view – [your tab label]). This will tell the plugin to display the field under those tabs.
9. Click Save Changes.

If you need more control over how the fields are displayed in each view, you can edit the following template files:

- directory_listing_single_full.html.php (Detailed view)
- directory_listing_single_summary.html.php (List view)
- directory_listing_single_column.html.php (Grid view)

To display a specific field in the above template files, e.g. field_xxx, you can use the following code:

<?php echo $this->Entity_RenderField($entity, 'field_xxx');?>

Refer to the question “How can I customize the display?” for more details on editing template files.

Version 1.2.x

All custom fields are displayed by default on the single listing page. If you would like them to be displayed for each listing on the directory index page, then you will need to modify the directory_listing_single_summary.html.php template file located under wp-content/plugins/sabai-directory/assets/templates. Refer to the question “How can I customize the display?” for more details on editing template files.

You can add the following code to the template file to display all custom fields:

<div class="sabai-directory-custom-fields">
    <?php $this->renderTemplate('directory_custom_fields', array('entity' => $entity));?>
</div>

If you need to display a specific field, e.g. field_xxx, then you can use the following code in the template file:

<?php echo $this->Entity_RenderField($entity, 'field_xxx');?>

How can I style custom fields?

The following is the structure of the HTML markup of custom fields:

<div class="sabai-directory-custom-fields">
    <div class="sabai-directory-field sabai-field-type-[Field Type] sabai-field-name-field-[Field Name] sabai-clearfix">
        <div class="sabai-field-label">[Field Title]</div>
        <div class="sabai-field-value">[Field Value]</div>
    </div>
    ...
</div>

Here is an example of the HTML markup for a Single Line Text field:

<div class="sabai-directory-field sabai-field-type-string sabai-field-name-field-hours sabai-clearfix">
    <div class="sabai-field-label">Opening Hours</div>
    <div class="sabai-field-value">Mon-Sun 5:30 pm - 10 pm, Sat-Sun 5:30 pm - 9 pm</div>
</div>

As you can see, the field type and the field name are used as part of the CSS class names, so you can target specific fields to style them however you like.

If you want to go further to modify the HTML markup generated by SabaiDirectory, you can edit the directory_custom_fields.html.php template file located under wp-content/plugins/sabai-directory/assets/templates. Refer to the question “How can I customize the display?” for more details on editing template files.

How can I exclude certain custom fields from being displayed on the main content of the single listing page?

Follow the exact same steps instructed in the following FAQ but check off the Display this field option instead of checking it on.

How can I display custom fields?

Version 1.2.x

You can exclude specific fields from the custom fields list (those displayed above the tabs) by modifying the directory_custom_fields.html.php template file. Refer to the question “How can I customize the display?” for more details on editing template files.

For example, if you need to exclude custom fields named field_my_field and field_my_field2, modify the following line in the template file:

<?php foreach ($this->Entity_CustomFields($entity) as $field):?>

to
<?php foreach ($this->Entity_CustomFields($entity,
array('field_my_field', 'field_my_field2')) as $field):?>

How do I add my custom content at the top/bottom of the directory index page?

There are several ways to do this:

1. %sabai% placeholder

Go to the Pages section in the WordPress dashboard, and edit the page you have specified for the Directory Index Page in Directory -> Settings -> Pages. In the content section of the page, you can use the %sabai% placeholder which will be replaced with the content of the plugin. For example:

<p>My custom header</p>

%sabai%

<p>My custom footer</p>

This will however affect other pages in the plugin as well, so if you do not like that then you should assign different pages for Category List, Review List, Photo List, and Single Listing pages in Directory -> Settings -> Pages.

2. sabai_directory_before_listings/sabai_directory_after_listings action hooks

You can add the following action hook functions to your theme functions.php or a new file at wp-content/sabai/functions.php:

To add your custom content above listings:
add_action('sabai_directory_before_listings', 'my_sabai_directory_before_listings', 10, 2);
function my_sabai_directory_before_listings($addonName, $settings)
{
    if ($settings['category'] === 0) { // the main index page does not have a category
        echo '<p>My custom header</p>';
    }
}
To add your custom content below listings:
add_action('sabai_directory_after_listings', 'my_sabai_directory_after_listings', 10, 2);
function my_sabai_directory_after_listings($addonName, $settings)
{
    if ($settings['category'] === 0) { // the main index page does not have a category
        echo '<p>My custom footer</p>';
    }
}

3. directory_listings.html.php template file

You can edit the directory_listings.html.php file which you can find under wp-content/plugins/sabai-directory/assets/templates and add any custom content anywhere in the template file. Please see the following FAQ for more details on how to customize the display with template files.
http://codecanyon.net/item/sabai-directory-plugin-for-wordpress/4505485/faqs/15151

How do “Leads” work?

Leads are contact information which users submit using a form under the Contact Us tab on each single listing page. A notification email is automatically sent (if enabled) to the email address of the listing owner when new leads are submitted. Listing owners can also view and manage their leads in their directory dashboard.

The Contact Us tab is only visible if the listing has been claimed and the user viewing the listing has the right permission to submit leads. The Contact Us tab must also be enabled under the Single listing page tabs setting in the Display Settings section of the plugin.

There are 2 permissions regarding submitting leads that can be assigned to each user role on the Access Control page (Directory -> Settings -> Access Control). The Add leads permission will allow users to submit leads but require administrator approval before a notification mail is sent to the listing owner or become viewable in the listing owner’s directory dashboard. The Add leads (without approval) permission will allow leads submitted by the users with the permission to become viewable and notified to listing owners immediately without any approval required. Note that the Add leads (without approval) permission requires the Add leads permission to become effective.

How do I disable reviews?

There is no option to disable the feature but you can virtually do so by hiding the Reviews tab by unchecking the tab in Directory -> Settings -> General -> Single listing page tabs so no reviews are displayed and also removing the Add reviews permission from all user roles in Directory -> Settings -> Access Control so no one can submit reviews.

How do I disable photos?

You can:

  • Disable the photo upload field from Directory -> Listings -> Fields -> Manage Form by editing the Photos field from there. In addition to checking the Disable option, make sure to uncheck the Display this field option under all Display Settings sections.
  • Hide the Photos tab by unchecking the tab under Directory -> Settings -> General -> Single listing page tabs.
  • Remove the Add photos permission from all users in Directory -> Settings -> Access Control to make sure no one can upload photos.

What are the benefits for listing owners claiming their listings?

When you claim your listing you get a number of benefits:
  • your listing is locked so that you are the only person who can update it (via the directory dashboard)
  • your listing becomes ‘verified’ adding additional trust and credibility
  • get instant email alerts when anyone posts a review or add photos to your listing
  • add and manage ‘official’ photos on the frontpage of your listing (via the directory dashboard)
  • your listing may be featured on top page
  • your listing may have fields that unclaimed listings do not have
  • your listing may have additional categories associated
  • your listing may have additional locations
  • your listing may have additional photos
  • your listing may have additional tabs
  • collect leads through the Contact Us form on the listing page

How can I disable claiming?

Go to Directory (or cloned add-on name) -> Settings -> Access Control and remove the “Claim existing listings” permission from all user roles. Note that since the administrator role always have all permissions, you can not disable claiming for users with the administrator role.

How to add lightbox effect to photos and images?

We recommend installing the “Responsive Lightbox” plugin, and then select “prettyPhoto” as the lightbox script in the settings of the plugin. Another plugin that we recommend is the “WordPress prettyPhoto” by Babar, which we currently use on our demo site.

I would like to have guest users submit listings and have them registered at the same time.

  1. Make sure user registration is enabled in WordPress, under Settings -> General. (No longer required since version 1.3.12)
  2. Go to Directory -> Settings -> Access Control and give the Add listings permission to the Guest user role.
  3. Go to Directory -> Settings -> General and select Yes for the Show user registration form when guest user is submitting a listing option.
  4. Optionally, go to Directory -> Settings -> General and select Yes for the Allow guest user to skip user registration option which will let guest users skip user registration and submit listings anonymously. Note that this option is only displayed only when you have selected Yes in step 2. In addition, since guest users may not claim listings, they only become authors of their listings instead of owners.

How do I hide the “No Image” image displayed for each listing on the directory index page and category pages?

You can hide them by adding the following CSS rules to your theme style.css or to a new file at wp-content/assets/style.css (you must create the directory and/or file if not already there) if you do not wish to lose this modification when your theme updates.

.sabai-directory-no-image .sabai-directory-images {
  display: none;
}
.sabai-directory-no-image .sabai-directory-main {
  width: 100%;
}

My custom single listing page tab does not appear!

For unclaimed listings, please make sure that the tab is selected under Directory -> Settings -> Claims -> Unclaimed Listing Settings -> Single listing page tabs.

If you have the paid listing feature of the plugin enabled, please go to Directory -> Listings -> Plans and edit the plan(s) that you would like to have the tab enabled, and check the tab under Basic Feature Settings -> Single listing page tabs.

Also the tab will not appear if there is no content to display under the tab. For example when there are no fields assigned with the tab or there are no values of the listing to display for fields assigned with the tab.

Is there a way to import CSV files?

Yes, the DirectoryCSVImport add-on will allow you to import CSV files from the admin dashboard. If you have not yet installed the add-on, please go to Settings -> Sabai and install the add-on from there.

After you have installed the add-on, go to Directory -> Listings and click on the green button that says Import CSV. This will take you to a page where you can upload a CSV file and import data to SabaiDirectory.

The CSV import wizard on the page allows you to map CSV columns with the default directory listing fields (and custom fields that are supported by the import wizard) so there is no fixed format for CSV files that you can upload.

To import categories associated with each listing, specify category slugs (not category names) in a single CSV column and separate them with delimiters. The delimiter can be any string character as long as it is not the same as the delimiter used to separate the CSV columns. You will be asked to enter the delimiter used to separate the categories in some point of the import wizard.

To import photos associated with each listing, specify photo file names in a single CSV column and separate them with delimiters. The delimiter can be any string character as long as it is not the same as the delimiter used to separate the CSV columns. You will be asked to enter the delimiter used to separate the photo file names in some point of the import wizard. You will also be asked to upload a zip file containing all your photo files that you specified in the CSV file. When creating the photo zip file, make sure to first create a folder containing all photo files, and create a zip file from that folder and name the zip file as the same name as you named the folder.

If you would like a sample CSV file and its associated photo files, you can download it from here.

You can also import categories from Directory -> Categories. A sample CSV file for importing categories and its associated thumbnail and map marker image files can be found here.

I can’t import my CSV file

Please make sure that:

- the CSV file has a header row

The CSV file needs to have a header row so that the columns in the CSV file can be associated with the directory listing fields.

- the “Convert encoding of CSV file data to UTF-8” option in the upload form is enabled if the encoding of the CSV file is not UTF-8

By checking the option, the importer will convert the file encoding of the CSV file to UTF-8. Check this option if the file encoding of your CSV file is not UTF-8 or unknown. If you are still getting errors, we suggest that you manually convert the file encoding of your CSV file to UTF-8 and then import it without this option enabled.

- the CSV file is not too large

If the size of your CSV file is very large, try splitting the file into smaller files. In addition, if the records in your CSV file do not contain latitude/longitude values and you are importing the records with the Use Google geocoding service option of the importer enabled, you can only import maximum of 2500 records a day, which is the max query limit of the Google geocoding API service, unless you have a Google Maps API business license.

- line breaks are CR/LF

The importer may not be able to import CSV data correctly if line breaks are CR or LF only.

How do I import post status of each listing with CSV?

You can import the post status of each listing by creating a column containing one of the values in your CSV file:

- published
- pending
- draft

You can then map the column with the Status field when importing your CSV file.

How can I manually edit title and meta description tags?

Make sure you have either the WordPress Seo by Yoast plugin or the All in One SEO Pack plugin installed and activated.

  1. From the WP admin dashboard, go to Directory -> Listings
  2. Click the Fields tab.
  3. From the Available Fields panel on the right (or left for RTL languages), click Single Line Text.
  4. Enter “meta_title” for Field name.
  5. Enter “Meta Title” for Label.
  6. Under Visibility Settings, unselect all checkboxes but the Administrator checkbox.
  7. Press the Add Field button to save the field.
  8. From the Available Fields panel on the right (or left for RTL languages), click Paragraph Text.
  9. Enter “meta_description” for Field name.
  10. Enter “Meta Description” for Label.
  11. Under Visibility Settings, unselect all checkboxes but the Administrator checkbox.
  12. Press the Add Field button to save the field.

Now, try editing one of your listings as administrator and you should see two new fields you just created. Enter values for these fields and they will replace the original values that were automatically generated by the plugin.

I can’t upload images or files.

Make sure the following folders exist and are writeable by the server (or the user running PHP).

  • wp-content/sabai/File/tmp
  • wp-content/sabai/File/files
  • wp-content/sabai/File/thumbnails

If you do not have the folders above, please create a folder at wp-content/sabai and make it writeable by the server. Other required folder will then be created automatically when you upload files.

In addition, if you are uploading non-images files using the upload feature, either FileInfo functions or the mime_content_type function enabled on your server for security reason. Image files can be uploaded without these functions.

I am getting the error “Google geocoding service did not respond with OK status. Returned status: OVER_QUERY_LIMIT” when doing a search in the directory.

The Google Geocoding API has the following limits in place:

  • 2,500 requests per 24 hour period.
  • 10 requests per second.

Since the request quota is calculated per IP address, it may be that another site on your server is also using the API.

In order to resolve the issue, you can request a Google Geocoding API key from Google and specify it from Settings -> Sabai -> GoogleMaps (gear icon).

To create your API key:
  1. Visit the APIs console at https://code.google.com/apis/console and log in with your Google Account.
  2. Click the Services link from the left-hand menu in the APIs Console, then activate the Geocoding API service.
  3. Once the service has been activated, your API key is available from the API Access page, in the Simple API Access section.

Version 1.2.x

If you are using version older than 1.3.0 but later than 1.2.31, then you can specify the Google Geocoding API key by adding the following line to anywhere in your wp-config.php file:
define('SABAI_GOOGLEMAPS_GEOCODING_APIKEY', 'Your Google Geocoding
API key here');

Can I use shortcodes in listings?

Shortcodes are supported by the default Listing Description field and Paragraph Text type custom fields. However they are not processed by default. In order to have shortcodes in these fields processed, go to Directory -> Listings -> Fields -> Manage Form, hover over to the Listing Description field (or your Paragraph Text type custom field) and click the gear icon to edit the field. In the popup form, scroll down to Display Settings (Detailed view) and check the Process shortcode(s) option and press Save Changes.

In addition, for security reasons, by default shortcodes are processed for listings authored (or claimed for claimed listings) by users with the Administrator role. In order to process shortcodes in listings by other user roles, go to Settings -> Sabai -> WordPress (click gear icon) and select users roles under the User roles allowed to use shortcodes in content option and press Save Changes.

How can I assign multiple categories to a listing?

By default (if you have initially installed versions older than 1.2.19), SabaiDirectory allows only one category to be associated with each listing. To change this, follow the steps below:

  1. From the WP admin dashboard, go to Directory -> Listings
  2. Click the Fields tab
  3. Scroll down to the Category field and click on the small Edit button which appears when you hover over the field
  4. Change the Maximum number of values to something other than 1
  5. Press Save Changes

How to allow multiple locations for each listing?

By default only one location is allowed to be associated with each listing. To change this, follow the steps below:

  1. From the WP admin dashboard, go to Directory -> Listings
  2. Click the Fields tab
  3. Scroll down to the Location field and click on the small Edit button which appears when you hover over the field
  4. Change the Maximum number of values to something other than 1
  5. Press Save Changes

How can I use a custom marker icon for directory listing maps?

Go to Directory -> Settings and under the Map Settings section there is a text field titled “Custom marker icon URL” where you enter the URL of your custom marker icon.

It is also possible to use a custom marker icon for each category. To do so, all you need to do is upload a custom marker image file when creating a category from Directory -> Categories.

How do I create multiple directories?

To create a new directory, you will need to clone the Directory add-on.

  1. From the admin dashboard, go to Settings -> Sabai.
  2. Under the Sabai Add-ons section, find the row for the Directory add-on and click the blue button on the right.
  3. Enter the name of add-on you would like to create. The name of the add-on can be anything you like as long as it is unique within the system but do not choose a name that is likely to conflict with add-ons that would be released in the future.
  4. Submit the form and after the page refresh, you will see the add-on you just created listed in the Installable Add-ons table under the Sabai Add-ons section.
  5. Install the new add-on just like you did for the Directory add-on and you will see new menu items for the add-on added to the dashboard menu.
That’s it, you have just created a complete new directory.

Why would I need multiple directories?

Each instance of directories has a complete set of settings. So for example, you can create a restaurant directory with “Menu” and “Offers Alcohol” custom fields and a hotel directory with “Room Types”, “Check-in Time”, and “Facilities” fields. You can also allow certain users to submit reviews to the restaurant directory but not to other directories.

We could have enabled this on the category level, but because SabaiDirectory allows each listing to be associated with multiple categories, that would have become very complicated. – Category specific fields is now supported from version 1.3 of the plugin.

Ok, then how can I display listings from multiple directories?

You can use the [sabai-directory] shortcode to fetch and display listings from one or more directories of your choice. This page on the demo site displays listings from 3 directories (Businesses, Restaurants, and Stores) setup on the site.

How can I monetize my site?

You can install the PaidListings, PaidDirectoryListings add-ons included with the package which will add the Plans and Orders tabs to the listing index page of admin dashboard where you can configure pricing plans, manage orders.

You can also enable payment gateways of your choice by installing one or more of ManualPayment, PayPal, Stripe, AuthorizeNet, and 2Checkout add-ons from Settings -> Sabai.

How do users cancel their PayPal recurring payments?

Users need to login to their PayPal account page and cancel their recurring payment profiles. When a recurring payment profile is cancelled, an IPN (Instant Payment Notification) message will be sent to the IPN endpoint URL of your site and mark the listing associated with the recurring payment profile as cancelled. The claim and features attached to the listing will all be removed.

In order to properly receive IPN messages from PayPal:
  1. Login to your PayPal merchant account page.
  2. Click Profile -> My Selling Tools on the navigation bar.
  3. Click Update in the Instant payment notifications column under the Getting paid and managing my risk section.
  4. Specify the IPN endpoint URL of your site (which can be found under Settings -> Sabai -> PayPal in your WordPress admin dashboard) in the Notification URL field.
  5. Click Receive IPN messages (Enabled) to enable your listener.
  6. Click Save.

How do users cancel their Stripe recurring payments?

At this moment (version 1.3.11), canceling Stripe recurring payment subscriptions requires manual cancellation by yourself, not by users. We will be adding an interface for canceling subscriptions through the frontend directory dashboard to the later version of the plugin.

I would like users with the Editor role to have access to the backend side of the plugin in the WordPress dashboard.

User roles with the manage_sabai capability can access Settings -> Sabai, and roles with the manage_sabai_content capability can access the pages under Directory. You can grant capabilities to user roles using another plugin like the Members plugin. https://wordpress.org/plugins/members/

I can not find the address (Google Maps) field on the backend or on the frontend.

This happens when you install the Directory add-on and then the GoogleMaps add-on after that. The address field is created by the GoogleMaps add-on so currently it must be installed prior to installing the Directory add-on.

In order to fix this, please go to Directory -> Settings and just press the Save Changes button.

Any recommended plugins to use with SabaiDirectory?

The WordPress Seo by Yoast plugin is highly recommended which if installed generates title and meta description tags automatically for each listing and category. SabaiDirectory also supports breadcrumbs generated by WordPress Seo. Please visit the demo site to see it in action. Also please see the documentation by Yoast here for details on displaying breadcrumbs in your theme.

As of version 1.2.10, support for the All in One SEO Pack plugin has been added which if installed will also generate title and meta description tags automatically for each listing and category.

As of version 1.3, support for the SEO Ultimate plugin has been added which if installed will also generate title and meta description tags automatically for each listing and category.

Is there RSS feed for Sabai Directory

Yes, Sabai Directory generates RSS feeds for all your directories (site-wide) and also for each directory. For example, the following is a list of some RSS feeds on our demo site:

Site-wide most recent listings and reviews
http://demo.sabaiapps.com/sabaidirectory/sabai/directory/feed
Site-wide most recent listings
http://demo.sabaiapps.com/sabaidirectory/sabai/directory/feed?type=listing
Site-wide most recent reviews
http://demo.sabaiapps.com/sabaidirectory/sabai/directory/feed?type=review
Most recent business listings and reviews
http://demo.sabaiapps.com/sabaidirectory/businesses/feed
Most recent business listings
http://demo.sabaiapps.com/sabaidirectory/businesses/feed?type=listing
Most recent business listing reviews
http://demo.sabaiapps.com/sabaidirectory/businesses/feed?type=review

To view the RSS feeds on your site, replace the http://demo.sabaiapps.com/sabaidirectory/ part with your WP site URL and the businesses part with the directory slug on your site.

I have a problem after updating the plugin.

Please make sure that you have:

  • All Sabai plugins updated to the same version. You can check the versions on the Plugins page of WordPress admin dashboard. You do not need to deactivate or delete any of our plugins!
  • Updated all add-ons from Settings -> Sabai.
  • Cleared cache from Settings -> Sabai after doing all the above.

If this does not fix the issue, please contact support from here: http://codecanyon.net/item/sabai-directory-plugin-for-wordpress/4505485/support

I see there are already a number of Google Maps styles available with the plugin under Directory -> Settings -> Map, but how can I add my own?

First, create a javascript file which includes custom style definitions. You can take a look at the style definitions included with our plugin by default under wp-content/plugins/sabai-googlemaps/assets/js. You can also find other custom style definitions here as well: https://snazzymaps.com/

Next, upload your javascript file to wp-content, for example: wp-content/sabai-googlemaps-map-my-custom-style.js. Then, create a new file wp-content/sabai/functions.php if you do not already have this file, and in that file paste the following code:

<?php
add_filter('sabai_googlemaps_styles', 'my_sabai_googlemaps_styles');
function my_sabai_googlemaps_styles($styles)
{
    $styles['My Custom Style'] = content_url('sabai-googlemaps-map-my-custom-style.js');
    return $styles;
}

The My Custom Style part will be used as the label for the custom map style displayed in Directory -> Settings -> Map. Also Make sure that the sabai-googlemaps-map-my-custom-style.js part matches the name of javascript file that you uploaded.

How do I update the plugin from version 1.2.x?

Step 1: Update Files

Unfortunately updating from version 1.2 to 1.3 is not possible using the online update. You must manually delete the sabai and sabai-directory folders from the wp-content/plugins directory using an FTP software.

Also if you have been using cloned add-ons, make sure to delete all files under wp-content/sabai/System/clones.

Then, upload the new plugin folders (sabai, sabai-directory, sabai-googlemaps, and sabai-paidlistings folders) to wp-content/plugins. You should NOT deactivate nor delete any sabai plugins from the Plugins page of WordPress dashboard.

After uploading the folders, go to the Plugins page of WordPress dashboard. You may see an error message saying that certain add-ons are not installed or a white screen.

However, do not worry and reload the page a few number of times until the page displays correctly, and then activate Sabai Directory, Sabai Google Maps, and Sabai Paid Listings plugins.

Step 2: Update Data

Next, go to Settings -> Sabai from the Wordpress administration dashboard and under the Sabai Add-ons section, upgrade all add-ons that are highlighted and have the Upgrade button displayed. Press the Upgrade button for each of these add-ons and follow the instructions displayed on the pop-up window. You can also do a bulk upgrade by checking the checkboxes on the left and pressing the Upgrade Checked button. Note that some add-ons may not be upgraded until certain add-ons have been upgraded first. Make sure to upgrade all add-ons until all add-ons are de-highlighted.

Also, depending on the upgrade package, there may be some add-ons that are newly available for installation. These add-ons will be listed on the Installable Add-ons table below the list of installed add-ons so you can click the Install button for each of them to make them active.

Step 3: Clear Cache

The last step is very simple. Go to Settings -> Sabai from the Wordpress administration dashboard and under the System Settings section, click the button labelled Clear Cache. If the cache is successfully cleared, you should see a green check button displayed next to the button that you just clicked.

That’s it, you should have now successfully updated Sabai Directory to the latest version.

Single listing page tabs do not work properly with the Divi theme.

This is because of a custom javascript code of the Divi theme hijacking all local links on that page (links with #) and disables the switching functionality of the tabs.

In order to fix this, you will need to add the following modifications to around line 3408 of wp-content/themes/Divi/js/custom.js:

$( 'a[href*=#]:not([href=#])' ).click( function() {

to

$( 'a[href*=#]:not([href=#])' ).click( function() {
    if ($(this).closest('.sabai-nav').length) {
        return;
    }

For Divi 2.3 and older

In order to fix this, you will need to add the following modifications to around line 2642 of wp-content/themes/Divi/js/custom.js:

$( 'a[href*=#]:not([href=#])' ).click( function() {
    if ( $(this).closest( '.woocommerce-tabs' ).length && $(this).closest( '.tabs' ).length ) {
        return false;
    }

to

$( 'a[href*=#]:not([href=#])' ).click( function() {
    if ($(this).closest('.sabai-nav').length) {
        return;
    }

    if ( $(this).closest( '.woocommerce-tabs' ).length && $(this).closest( '.tabs' ).length ) {
        return false;
    }

Note that the code above is based on version 2.3.1 of the Divi theme.

How can I style directory pages with Visual Composer or Divi Builder?

By default, our plugin removes any content added by other plugins (via the the_content WordPress filter hook) to our plugin pages in order to avoid possible display conflicts.

Therefore you will first need to disable this feature by adding the following line of code to wp-config.php:

define('SABAI_WORDPRESS_DISABLE_REMOVE_FILTERS', true);

above where it says:

/* That's all, stop editing! Happy blogging. */

Then, using a text type component of your editor (e.g. Text Block in Visual Composer or Text Module in Divi Builder), insert the %sabai% placeholder to where you would like the content of our plugin to be displayed, which will be replaced with the actual content of our plugin in the frontend. For example:

<p>My custom content</p>

%sabai%

<p>My custom content</p>

Also make sure that you are using version 1.3.24 or later of our plugins.

How do I enable iframes in listing descriptions?

This method no longer works with the plugin. Instead, please use WordPress embeds.

  1. From the WP admin dashboard, go to Directory -> Listings
  2. Click the Fields tab.
  3. Hover over to the Listing Description field and click on the small Edit link which appears at the top right corner.
  4. Mark the checkbox which says Allow iframe HTML tags.
  5. Optionally, add the URL of the content you would like to embed, e.g., //www.youtube.com/embed/, to Iframe URL Whitelist. Make sure to separate the URLs with commas if entering more than one URL.
  6. Click the Save Changes button.

How do I enable iframes in user reviews?

This method no longer works with the plugin. Instead, please use WordPress embeds.

  1. From the WP admin dashboard, go to Directory -> Reviews
  2. Click the Fields tab.
  3. Hover over to the Review field and click on the small Edit link which appears at the top right corner.
  4. Mark the checkbox which says Allow iframe HTML tags.
  5. Optionally, add the URL of the content you would like to embed, e.g., //www.youtube.com/embed/, to Iframe URL Whitelist. Make sure to separate the URLs with commas if entering more than one URL.
  6. Click the Save Changes button.

Show more

Contact the author

This author provides limited support for this item through email contact form.

Item support includes:

  • Availability of the author to answer questions
  • Answering technical questions about item’s features
  • Assistance with reported bugs and issues
  • Help with included 3rd party assets

However, item support does not include:

  • Customization services
  • Installation services

View the item support policy

by
by
by
by
by
by