Directory Prices & Payment Features

Tips and tricks

  1. When activating the Pricing Manager addon, don’t forget to review the settings of the default package.
    Installation of the GD core plugin creates a default listing type that allows users to add all fields, unlimited categories and images etc.
  2. Importing listings: Set up your price packages and custom fields before creating your CSV file.

Introduction

  1. You can use the Pricing Manager to create different packages, for example Featured listings, listings with or without certain custom fields etc

Installation

  1. You can install the Pricing Manager first, and then WP Invoicing if you want to take payments.
  2. You can install and activate them in any order.
  3. Follow the installation instructions here.

Configuration

  1. After plugin activation, you will be redirected to the Prices and Payments configuration page:
  2. Start with configuring the General settings (see below),
  3. then set up your payment gateways in the Payment tab (see below),
  4. and then you can create your different price packages (see below).

General Tab

Enable expiry process?

  1. If you disable this option, none of the listings will expire in future.
  2. Select the listing status after the listing expires. The following options are available:
    1. Draft – After expiration listing will be converted to draft.
    2. Publish – After expiration listing will still be displayed.
    3. Trash – After expiration listing will be moved to trash.

Paid Listing Status

  1. If you are taking payments for your listings, select here what should happen when a listing is submitted and payment has been made:
    1. Publish – The listing will be live on your website immediately, this is the default setting.
    2. Pending Review
    3. Draft

Enable pre expiry notification to author?

  1. Select this if you do not want to send expiry notices to your users.

Display expiry date to author in dashboard listings?

  1. This will display the end date of the listing for the user only:
  1. Display expire date to author in listing detail sidebar?
    1. Display expire date to author in listing detail sidebar? If you tick the option, listing expire date will be displayed to listing author in listing detail sidebar.

GeoDirectory Manage Currency

  1. Default Currency (Ex.: USD)
    1. Enter a valid ISO 4217 currency code.
    2. Payments will be charged in this currency.
  2. Default Currency Symbol (Ex.: $)
    1. The currency symbol of your 3 letter currency code.

Prices Tab

Add Price

  1. Price title
    1. This will be your package title.
  2. Post type
    1. The post type of this package.
  3. Post fields
    1. Select the post fields available for this package.
    2. For example, if you select only time field for this package, then it looks like this.
  4. Price amount ( $ )
    1. Package price
  5. Recurring payment?
    1. Is this a recurring package? (Note: Only supported by PayPal)
  6. Number of Days
    1. Subscription validity in days. (set to 0 to never expire)
  7. Status
    1. Is this package active or inactive?
  8. Is featured
    1. Is this a featured package?
  9. Is default
    1. Is this the default package?
    2. Default package will be automatically selected, when you load add listing page.
  10. Display Order
    1. Display sort order on front end package listing
    2. In the following screenshot
      1. Premium Plus – Display order set to 1
      2. Premium – Display order set to 2
  11. Exclude categories
    1. Select multiple categories to exclude by holding down “Ctrl” key.
    2. If removing a parent category, you should remove its child categories.
    3. It is not recommended to exclude categories from live packages as users will not be able to remove that category from the frontend.
    4. Excluded categories will be removed from add listing form category dropdown.
  12. Expire, Downgrade to
    1. When a listing get expired, do you want to let it expire? OR downgrade package?. If downgrade which package? Note: You need to have more than 1 packages if you are planning to use downgrade option.
  13. Title to be display while add listing
    1. Example: Premium: 30 days  (5.00 USD)
    2. Keep blank to use default. Default text looks like this ( Premium : number of publish days are 0 () )
    3. In add listing page, it would look like this with default text.
    4. With custom text, it would look like this
  14. Image limit
    1. The maximum number of images a user can upload to the listing.
    2. For example: If you set the value to 5, in add listing page it would look like this.
  15. Category limit
    1. The maximum number of categories, a user can select to a listing.
    2. For example, If you set it to 3, The category dropdown will not be available after selecting 3 categories.
  16. Apply description limit?
    1. Select Yes if you would like to apply description limit.
      1. Description limit
        1. Characters limit for listing description
        2. Ex: If you enter 140, then user cannot enter more than 140 characters.
  17. Apply tags limit?
    1. If set to NO the default character limit of 40 will be used.
    2. Select Yes if you would like to apply tags limit.
      1. Tags limit
        1. Characters limit for listing tags
        2. Ex: If you enter 50, then user cannot enter more than 50 characters for tags.
  18. Google analytics
    1. Select Yes if you would like to enable Google Analytics for this package?
    2. If set to Yes
      1. Make sure you configured Geodirectory > General > Google Analytics section correctly. Refer this page if you need help.
      2. Make sure Geodirectory > Design > Detail > Disable Google Analytics section not checked.
      3. Google Analytics will be visible in detail page sidebar.
  19. Send To Friend
    1. Select Yes if you would like to enable Send To Friend option for this package?
    2. Send To Friend will be visible in Listing Information if set to Yes
  20. Hide related listing tab
    1. Select Yes if you would like to hide related listing tab for this package?

Payments Tab

Paypal Settings  

  1. Payment Method
    1. The title of the Payment Method.
    2. This title will be displayed to users.
  2. Is Active
    1. Is this payment method Active?
  3. Display Order
    1. Display order for frontend display.
    2. For example when set to 1 this will be displayed first.
    3. Note: Don’t use the same display order for all Payment Methods.
  4. Mode
    1. Live – All transactions will be real money transactions.
    2. Test mode (Sandbox) – All transactions will be dummy transactions.
  5. Merchant Id
    1. This will be your PayPal Email address.
    2. Make sure, you are entering your email address correctly.
  6. Cancel Url
    1. This is the url which will be used to redirect the user, if the user cancels the transaction.
    2. Leave it to default, unless you know what you are doing.
  7. Return Url
    1. This is the url which will be used to redirect the user, after successful transaction.
    2. Leave it to default, unless you know what you are doing.
  8. Notify Url
    1. This is the url, where you would like PayPal to use to notify the transaction status.
    2. Leave it to default, unless you know what you are doing.

Google Wallet Settings

  1. Payment Method
    1. The title of the Payment Method.
    2. This title will be displayed to users.
  2. Is Active
    1. Is this payment method Active?
  3. Display Order
    1. Display order for frontend display.
    2. For example when set to 1 this will be displayed first.
    3. Note: Don’t use the same display order for all Payment Methods.
  4. Mode
    1. Live – All transactions will be real money transactions.
    2. Test mode (Sandbox) – All transactions will be dummy transactions.
  5. Merchant Id
    1. Your Google Payments Merchant ID is a unique, numeric code assigned to your business by Google.
    2. Sign in to the Google Payments Merchant Center.
    3. Click on Settings on the left then click Public Profile.
    4. Your Google Payments Merchant ID will be listed at the top of the page.
  6. Merchant Secret
    1. Sign in to the Google Payments Merchant Center.
    2. Click on Settings on the left then click Public Profile.
    3. Your Google Payments Merchant Secret will be listed at the top of the page.
  7. Notify URL
    1. This is the url, where you would like Google to use to notify the transaction status.
    2. Leave it to default, unless you know what you are doing.

Authorize.Net Settings

  1. Payment Method
    1. The title of the Payment Method.
    2. This title will be displayed to users.
  2. Is Active
    1. Is this payment method Active?
  3. Display Order
    1. Display order for frontend display.
    2. For example when set to 1 this will be displayed first.
    3. Note: Don’t use the same display order for all Payment Methods.
  4. Mode
    1. Live – All transactions will be real money transactions.
    2. Test mode (Sandbox) – All transactions will be dummy transactions.
  5. Login ID
    1. To get Login ID
      1. Visit Authorize.Net
      2. Navigate to Home > Account > Settings > Security Settings > General Settings > API Login ID and Transaction Key
      3. To create an API Login ID or Transaction Key for the first time
        1. Type in your Secret Answer. You should have configured a Secret Question and Secret Answer during account activation.
        2. Click Submit to continue or click Cancel to cancel the action. The API Login ID and Transaction Key generated for your payment gateway account appear.
  6. Transaction Key
    1. To get Transaction Key
      1. Visit Authorize.Net
      2. Navigate to Home > Account > Settings > Security Settings > General Settings > API Login ID and Transaction Key
      3. To create an API Login ID or Transaction Key for the first time
        1. Type in your Secret Answer. You should have configured a Secret Question and Secret Answer during account activation.
        2. Click Submit to continue or click Cancel to cancel the action. The API Login ID and Transaction Key generated for your payment gateway account appear.

WorldPay Settings

  1. Payment Method
    1. The title of the Payment Method.
    2. This title will be displayed to users.
  2. Is Active
    1. Is this payment method Active?
  3. Display Order
    1. Display order for frontend display.
    2. For example when set to 1 this will be displayed first.
    3. Note: Don’t use the same display order for all Payment Methods.
  4. Mode
    1. Live – All transactions will be real money transactions.
    2. Test mode (Sandbox) – All transactions will be dummy transactions.
  5. Instant Id
    1. The unique reference number assigned by the WorldPay payment service to a single merchant installation for a Business Gateway merchant. Merchants can have one or more installation IDs which can be used in live mode or in test mode. Also known as instID or Instant ID.
    2. Where can I find it?
      1. Log in to the Merchant Administration Interface using your username and password by visiting this link:
      2. https://secure.worldpay.com/sso/public/auth/login.html?serviceIdentifier=merchantadmin
      3. Click Installations on the left hand menu and you will see your Installation ID number (6-digit numbers)
  6. Account Id
    1. To find your WorldPay Merchant Code, log into your WorldPay account with the username and password given to you by WorldPay.
    2. Click the Payments link in the left hand menu.
    3. Your Merchant Code will be displayed.

2CO ( 2Checkout ) Settings

  1. Payment Method
    1. The title of the Payment Method.
    2. This title will be displayed to users.
  2. Is Active
    1. Is this payment method Active?
  3. Display Order
    1. Display order for frontend display.
    2. For example when set to 1 this will be displayed first.
    3. Note: Don’t use the same display order for all Payment Methods.
  4. Mode
    1. Live – All transactions will be real money transactions.
    2. Test mode (Sandbox) – All transactions will be dummy transactions.
  5. Vendor ID
    1. The 2Checkout seller ID number (also known as the SID, the vendor ID, or the Account number) can be found within your vendor area, there is an image in the upper right hand corner that contains it.
  6. Notify Url
    1. This is the url, where you would like 2CO to use to notify the transaction status.
    2. Leave it to default, unless you know what you are doing.

Pre Bank Transfer Settings

The users will have to manually transfer the amount in the account ID you have mentioned here

  1. Payment Method
    1. The title of the Payment Method.
    2. This title will be displayed to users.
  2. Is Active
    1. Is this payment method Active?
  3. Display Order
    1. Display order for frontend display.
    2. For example when set to 1 this will be displayed first.
    3. Note: Don’t use the same display order for all Payment Methods.
  4. Mode
    1. Live – All transactions will be real money transactions.
    2. Test mode (Sandbox) – All transactions will be dummy transactions.
  5. Account Name
    1. Enter the bank name to which you want to transfer payment
    2. Example: ICICI Bank
  6. Account SC
    1. Enter your bank Account Sort Code
    2. Example: 11-22-33
  7. Account No
    1. Enter your bank Account Number
    2. Example: AB1234567890

Invoices Tab

GeoDirectory Manage Invoice

  1. Listing
    1. Listing name appears in this column
    2. front – The front end listing detail page link
    3. back – The back end edit listing link.
  2. Type
    1. Free – Free Listing since the package doesn’t require any payment.
    2. Paid – Paid Listing since the package require payment.
  3. Package Information
    1. Date – The subscription start date. This will be generated at the time of payment.
    2. ID – The Package ID
    3. Amount – The Package Price.
    4. Alive Days – The Package Validity.
  4. Coupon
    1. Applied Coupon code
    2. Na – When no coupon applied.
  5. Payment Information
    1. Discount – The discount amount
    2. Payable Amount – The amount payable after discount.
    3. Payment Method – Name of the payment method used for this payment.
  6. Status
    1. Paid – Payment Successful
    2. Unpaid – Payment not Successful.

Coupons Tab

GeoDirectory Manage Coupons

  1. Allow coupon option on submit Add Listing page
    1. When set to Yes coupon field will be displayed after package selection field.

Add Coupon

  1. Coupon Code
    1. This is the code that can be used by user to get discount.
    2. Example: If you are planning to give 10% discount then you can enter like 10OFF
  2. Post type
    1. Select the list of post type(s), this coupon can be applied.
  3. Discount Type
    1. Percentage(%) – Discount Amount will be treated as Percentage.
      1. Example: 10 will be treated as 10%.
    2. Amount – Discount Amount will be treated as Amount.
      1. Example: 10 will be treated as $10.
  4. Discount Amount ($)
    1. The discount amount value.
    2. Enter only numbers.
    3. Example: 10
  5. Recurring
    1. If applied to a recurring price package, how should it apply.
      1. All Payments – Coupon will be automatically applied for all payments.
      2. First Payment Only  – Coupon will be applied only for the first payment.
  6. Status
    1. Active – The coupon is active and can be used.
    2. Inactive – The coupon cannot be used

 

Notifications Tab

List of usable shortcodes

You can use these in the email templates to personalize your emails. The same fields are used in the notifications of the core plugin.

  1. [#client_name#] The name your user entered on registration
  2. [#listing_link#] Link to the user’s listing
  3. [#posted_date#] Date the listing was submitted
  4. [#number_of_days#] In case you use the Prices and Payments Addon, this is the amount of days the listing was originally paid for.
  5. [#number_of_grace_days#] In case you use the Prices and Payments Addon, this is the amount of days set at GD > Prices and Payments > General tab > Enable pre expiry notice days, and is the number of days before the listing will expire or be downgraded.
  6. [#login_url#] Your site’s login URL.
  7. [#username#] Your user’s unique username.
  8. [#user_email#] Your user’s email address.
  9. [#site_name_url#] The URL of your websit
  10. [#transaction_details#] will be automatically replaced with the payment transaction information.
  11. [#renew_link#] In case you use the Prices and Payments Addon, this is where your users can go to renew their listing.
  12. [#post_id#] will be automatically replaced with the listing ID.
  13. [#site_name#] The name of your site.
  14. [#from_email#] In most cases this will be your admin email, except for the Send to Friend  and the Email enquiry popup forms.  These forms will use automatically the email entered into the form by your site’s visitor.
  15. [#comments] These are the comments entered by your site’s visitor. Only relevant for the Send to Friend  and the Email enquiry popup forms.

Client Emails

Payment success to client email
  1. This email will be sent to the Client.
  2. This email will be triggered, after successful payment.
  3. Default subject is: Acknowledgment for your Payment
Post renew success to client email
  1. This email will be sent to the Client.
  2. This email will be triggered, after successful listing renewal.
  3. Default subject is: Renewal of listing ID:#[#post_id#]
Listing expiration email
  1. This email will be sent to the Client.
  2. This email will be triggered, X days before the listing expiration date. Where X is the number of days you set in GeoDirectory -> Prices and Payments -> Enable pre expiry notice days
  3. Default subject is: Place listing expiration Notification
Post Upgrade Success to Client Email
  1. This email will be sent to the Client.
  2. This email will be triggered, after successful listing upgrade.
  3. Default subject is: Upgrade of listing ID:#[#post_id#]

Admin Emails

Payment success to admin email
  1. This email will be sent to the Admin.
  2. This email will be triggered, after successful payment.
  3. Default subject is: Payment received successful
Post renewal success to admin email
  1. This email will be sent to the Admin.
  2. This email will be triggered, after successful listing renewal.
  3. Default subject is: Renewal of listing ID:#[#post_id#]
Post upgrade success to admin email
  1. This email will be sent to the Admin.
  2. This email will be triggered, after successful listing upgrade
  3. Default subject is: Upgrade of listing ID:#[#post_id#]
Payment fail to admin email
  1. This email will be sent to the Admin.
  2. This email will be triggered, when a payment get failed.
  3. Default subject is: IPN INVALID – Place Listing Submitted