About Post Types & How to Customize (default directory listings)

  1. Places is the name of the default Custom Post Type (CPT) installed as part of the GD core installation.
  2. It is like the top category for listings in your GD directory.
  3. The information on this page is also relevant for any other CPT you install when you add Custom Post Types or use the Event calendar.

Custom Fields

  1. When you go to GD > Place Settings, you will see a tab with Custom Fields.
  2. You will see a number of default custom fields already, like Category, Address, Website etc.
  3. You can add also your own fields, by choosing from the list of available types on the left hand side.

Common settings for Custom Fields

Admin title This title is only used to give a name to the Custom Field in the Custom Field settings area.
Frontend title This title is used on both the submission form and on the page where you choose the field to be displayed.
Frontend description Will be used on the submission form only, to help your users understand the information required.
HTML variable name Only used to create the custom field in your database.
Do not use spaces or special characters for this!
Is active Turns the field on or off across your site.
For Admin use only? Choosing YES here, will not allow your users to edit the field; only administrators will be able to edit this field.
 This option is only available for custom fields you create yourself, not for the default GD fields.
Default value A value used if the user does not enter anything.
Only relevant for some Custom Field types.
Show in what locations? Options here include:

  1. Details page sidebar: Adds it to the sidebar of the detail page of the listing
  2. More info tab: Adds the custom field to the “More info” tab
  3. Listings page: Adds the custom field to the listing display on the listings page (category page) and the search pages
  4. Details page own tab: Selecting this for a fieldset will create a new tab, selecting this for a custom field will show the custom field under the fieldset with the same setting above it
  5. Map bubble: Adds the custom field to the listings infowindows on every map
Show only on these price packages? This will only show if you have the Prices and Payments feature activated.
You can choose which price packages will be able to add this custom field.
If you have chosen the allowed fields in the price package itself already, then you do not need to set this again.
Is required Setting this to YES will make the field compulsory.
Required message If you set Is required to YES, then enter a message that will be displayed if the field is left empty.
Upload icon You can enter the URL of an icon you uploaded, or you can use a font awesome class.
Examples:

Entering fa fa-book will add an icon like this: 
Entering fa fa-camera-retro fa-3x will add an icon like this: 
CSS class: Here you can add a styling class that will be applied to the custom field when it is displayed on your site.
Every custom field is displayed in its own <div>, and the class will be added to that.
Include this field in sort option This will allow for listings on your listings and search pages, to be sorted by this field.
Include this field in advanced search This will only show if you have Advanced Search activated.
This will add the custom field as a possible filter to the GD Search.

Fieldset

  1. A fieldset helps you to group your custom fields.
  2. It is very much like a heading or a divider.
  3. A fieldset is only used to display on your pages, users cannot add data to it.
  4. If you select Details page own tab at the Show in what locations? selections, then a new tab will be created for the custom fields ordered under this fieldset, and which also have Details page own tab selected.

Text Custom Field

  1. Character type:
    1. Choose this type of field and your users will be able to enter any combination of letter, numbers, symbols etc.
  2. Number type:
    1. This type will return any number as a whole number only.
    2. For example if you enter 55.65, the field will display 55.
  3. Decimal type:
    1. This type will return any number with your choice of numbers behind the decimal point.
    2. For example if you have selected the decimal point as 3, and you enter 49.2, the field will display 49.200.

Multi Select Custom Field

  1. The Multi Select field allows your users to select a number of entries from a list you create.
  2. You have the choice of three display types: Select, Checkbox and Radio.
  3. Both Select and Checkbox allow your users to choose more than one item from your list.
  4. The Radio display type is used if your users should be restricted to one selection only.
  5.  You cannot use the following characters as part of your options: forward slash / or a comma ,
    (these characters are reserved for separating options and code).
  6.  Do not leave spaces between values when separated with commas.

Select Custom Field

  1. The Select Custom Field allows your users to select one option only from a list.
  2.  Select Custom Fields can also be added to the GD Search Bar.
  3.  You cannot use the following characters as part of your options: forward slash / or a comma ,
    (these characters are reserved for separating options and code).
  4. Example 1:
    1. Frontend Title: Serving
    2. You can allow a number of possible choices
    3. Option values: Coffee,Tea,Coffee and Tea
  5. Example 2:
    1. Frontend Title: Service offered
    2. You can enter the possible choices as options, and add more detailed text to be printed on the detail page
    3. Option values: Dog walking/We will walk your dog,Dog washing/Dogs shampooed and blowdried

Textarea Custom Field

  1. A textarea field allows for free-flowing text.

Checkbox Custom Field

  1. This allows a user to simply check a box, and then it will add the custom field title and the word Yes to the listing.

Radio Custom Field

  1. Similar to the Select Custom Field, but only requires a radio button to be selected.
  2.  Do not leave spaces between values when separated with commas.
  3. Example:
    1. Frontend Title: Available
    2. You can allow a number of possible choices, but the user can only select one of them
    3. Option values: Beer,Wine,Beer and Wine

URL Custom Field

  1. Allows your users to add additional links to their listing.
  2. Example 1:
    1. Frontend Title: Click here to visit our forum
    2. If they then enter their URL, it  will be linked
  3. Example 2:
    1. Frontend Title: Click here
    2. Your users can create links in this format: URL|anchor text
    3. For example when entering https://docs.wpgeodirectory.com|GeoDirectory documentationit will add a link

File Upload Custom Field

  1. Allow your users to upload most types of file.
  2. You can select the type of file that can be uploaded: Image, video, audio files and document types

Date Custom Field

  1. This will add a date picker to the Add Listing form.
  2. You can choose how the date will be displayed by adjusting the date format field:
    1. dd/mm/y = 02/10/15
    2. mm-dd-yy = 10-02-2015
    3. dd-M-yy = 02-Oct-2015

Time Custom Field

  1. Similar to the date field, the Time custom field will allow your users to select a time of day.

Phone Custom Field

  1. This field will make any phone number entered clickable and will connect with the relevant application on the device where the visitor is browsing your website.
  2. For example, this allows you to add extra phone fields for cell phones or office phone etc, in addition to the default phone field.

Email Custom Field

  1. This field will just print an email address as part of the listing.
  2. This is not the same as the default custom field for each listing, which will accept an email and create an online contact popup with a hidden email address.

HTML Custom Field

  1. This will add a textarea complete with a visual and text rich text editor, just like your post or page editor in your WordPresss admin area.

Sorting Options

In your Place Settings (or the settings of any other Custom Post Type) you have a tab called Sorting Options.

 

  1. The Sorting Options control how listings are ordered on your Listings (category) pages and in your search results.
     On the Search pages, only the default sort order will be used, and only if no keywords were used in the search.
  2. On the left hand side of the settings page, you will find a number of sorting options ready for you.
  3. You can add more options by going to your Custom Fields, and ticking the Include this field in sort option checkbox for the custom field you want to add to the sorting options.
  4. Click on any of the available sorting options on the left to make them available for sorting on your listings pages. Only the default option will be used in your search results.
  5. That will move the sorting options to the right hand side of the options page, and now you can edit the settings for the sorting options you have chosen.
  6. Edit the settings by clicking the sorting option, and then save.
    You can drag and drop the different field types to change the order in the sorting drop down on your pages.
    Setting one of the options as default, will automatically sort by that option.