PowerSeek SQL Documentation >> 10. Premium Links PowerSeek SQL Manual Index
1. Installation
2. The basics in 20 minutes
3. Settings
4. The Directory Manager
5 . Front Page Setup
6 . Customization (Look & Feel)
7 . Static / Dynamic Directory
8 . The User Manager
9 . Maintenance
10. Premium Links
11. Plugins
12. How To's, Tips & Tricks

13. PowerSeek SQL Mobile Edition

<< Previous Page
Maintenance.
Index Next Page >>
Plugins

ic_plugins.gif (983 bytes)

10. Premium Links

           10.1 What are premium links and how to add them?
           10.2 Premium Link Settings
                     10.2.1 Using Paypal as Payment Gateway with PowerSeek SQL

                     10.2.2 Using an alternative order processor other than PayPal
                     10.2.3 Premium Link Order Form Expiry Options
                     10.2.4 Other Premium Link Settings
           10.3 Sending Email to Premium Link Owners
           10.4 Retrieving Email Addresses of Premium Link Owners
           10.5 Customizing Premium Link Email Responses
           10.6 Expiry Emails
           10.7 Sending Expiry Emails to Premium Link Owners Who's Premium Links is About to Expire
           10.8 Browsing and editing premium links

           10.9 Customizing Premium Link Templates

 


10.1 What are premium links and how to add them?

Premium links are links that is always displayed first before any other link listings in any category. Premium links are also displayed first before any other links in the Control Panel. They can also be configured to display first in Search Results. Premium links can also have a different 'look and feel' or list extended information, images, etc. to differentiate premium links from standard links.
 
You can add premium links by clicking the ‘Add Link’ button when in the Dir Manager. When adding a link, assign a value in the Premium Position field to make it a premium link. You can give the premium link any value. If you have more than one premium link in the same category, the premium link values will determine which premium links are displayed first. The premium link with the highest value (number) will be displayed first and the premium link with the second highest value will be displayed second, etc.

You can also change any standard links to premium links. This can be done by editing any standard links and assigning Premium Position values to them.

To change a premium link so that it is not a premium link anymore, edit the premium link from the control panel. Then assign a Premium Position value of 0 (zero) to the  link's  Premium Position field. After this the premium link will be regarded as a normal link.

The templates used for premium links can be configured in the Template Manager of the Control Panel. This provides the option where premium links can have a different or enhanced look that separates normal links from premium links. All premium links can have an enhanced look that differentiates it from normal links, by customizing the premium link templates.

 

10.2 Premium Link Settings

To configure the main aspects of the premium links, go to the Control Panel > Plug-Ins > Premium Link Manager. Then click on the ‘Premium Link Settings’ link. Below is an explanation of each setting:

10.2.1 Using Paypal as Payment Gateway with PowerSeek SQL:

PowerSeek SQL will automatically redirect visitors to make payment with PayPal when PowerSeek SQL is configured to use PayPal. When payment by a user has been completed with PayPal then the link that was submitted will then be available as a premium link.


Important notes regarding the use of PayPal and new premium link submissions:

  • Note that new premium links that are submitted will still need to be approved from the Control Panel >> To Do >> Approve/Edit New Submissions by the Administrator before they will be available in the Index.
  • Also note that if a user cancels the transaction (chickens out) before payment is made with PayPal then the link submitted will be a standard link and not a premium link. The link submitted will only become a premium link if the Payment with PayPal was successful.


How to use PayPal to accept payments for premium links
:

To start using PayPal to accept payments for premium links, go to the PowerSeek Control Panel >> Settings >> Premium Link Settings

A popup window will appear. Tick the checkbox next to: 'Would you like to use PayPal?' and supply your PayPal details that is asked.

After saving the settings you may receive additional instructions depending on the setting options you have chosen. Follow the instructions if you receive instructions after saving the premium link settings.

There are additional PowerSeek templates that needs to be customized when using PayPal. The additional templates are displayed after a successful paypal purchase or after upgrading a standard link to a premium link with PayPal. These templates will need to be customized. To do that go to the Control Panel >> Template Manager >> 3. Add URL Templates >> User Registration System Add URL Templates

You will need to customize the following templates:
Success Page PayPal Purchase (rgs_regsuccess_paypal.html)
Upgrade Page Standard to Premium (rgs_upgrade.html)
Upgrade Page PayPal Purchase Success (rgs_upgrade_paypal_success.html)


Upgrading standard links to premium links with PayPal
:

Users can also upgrade standard links to premium links with Paypal.

If you would like to provide the option where users can upgrade standard listings to premium listings then do the following:

1. Go to the Control Panel >> Template Manager >> 3. Add URL Templates >> Control Panel Templates >> Account Link Style

2. Place the following somewhere inside the Account Link Style Template:
<a href="!!upgrade_to_premium!!">Upgrade to Premium Listing</a>

When a user upgrades a standard link to a premium link with PayPal then the link will automatically be available as a premium link after payment was successfully completed with PayPal. The Administrator will not have to approve the link to be available in the Index since it was already available in the Index as a standard link.

Using the PayPal Sandbox

You can test the entire ordering process with PayPal by configuring the PayPal mode setting to use the PayPal Sandbox. Note that you will need to open a PayPal sandbox account.

 

10.2.2. Using an alternative order processor other than PayPal:

The easiest way to accept Payments would be to use PayPal as PowerSeek SQL integrates PayPal with the PayPal API. If you want to use an alternative order processor then you can do that as well by choosing not to use PayPal in the premium link settings. The premium link settings are available from the Control Panel >> Settings >> Premium Link Settings

When PayPal is not in use then you will need to supply Order Form URLs for each 'Expiry Option'. When payment time arrives then the user will be redirected to the URL specified to make payment, according to the expiry option he/she has chosen.

Most order processors will have options where you add products with their system so that users can buy these products from a URL they provide you with. You supply the Order Form URL in the 'Premium Link Order Form Expiry Options' in the premium link settings. PowerSeek SQL then redirects people to these URLs when payment time arrives.

Most order processors will usually have additional options where you can pass on additional parameters to include additional information about the order in the Order Form URL.
For example: Let's say your order processor's order URL looks like this: http://someorderprocessor.com?product=30day_premium_link

If your order processor supports additional parameters that you can pass on to it then you could change the URL to look something like this for example:
http://someorderprocessor.com?product=30day_premium_link&additional_info=!!title!!

Using the URL above would then pass on the title of the link being submitted to your order processor so that you would know which payment was received for specific premium links submitted.

You can use the following variables in the Order Form URLs:
!!lnkid!! = The link ID of the link that was submitted.
!!cid!! = The category ID of the link that was submitted.
!!title!! = The title of the link that was submitted.
!!url!! = The URL of the link.
!!email!! = The email address for the link.
!!name!! = The contact person for the link.

10.2.3 Premium Link Order Form Expiry Options

The premium link expiry options allows you to provide different pricing options for different time intervals. You could for example charge $5 for 30 days, $10 for 3 months, $30 for 6 months, etc. These options will then be available to users when submitting premium links or upgrading standard links to premium links.

Note that you will be given instructions on what to do to enable the different expiry options after saving the premium link settings. The instructions will tell you what to do to provide your users with the selectable options when ordering. The premium link settings are available from the Control Panel >> Settings >> Premium Link Settings

10.2.4 Other Premium Link Settings

Would you like a 'Welcome Email' to be sent to users when they submit a premium URL?

You can customize the Welcome Email here:
PowerSeek SQL Control Panel > Plug-Ins > Premium Link Manager > Welcome Email

Would you like to be informed via email when a Premium URL is submitted?

You will be informed via email when a premium URL has been submitted when this is enabled. You can customize the Email here: Control Panel > Plug-Ins > Premium Link Manager > New Premium Submission Informer Email

Would you like to send an email to premium link owners that their there link will expire in one month:

This email can be customized when in the Control Panel >> Plugins >> Premium Link Manager >> Expiry Emails - (Note that you have to use a CRON program to send out emails. See the '10.1.6 Expiry Emails' for more on this)

Would you like to send an email to premium link owners that their there link will expire in one week:

This email can be customized when in the Control Panel >> Plugins >> Premium Link Manager >> Expiry Emails - (Note that you have to use a CRON program to send out emails. See the '10.1.6 Expiry Emails' for more on this)

Would you like to send an email to premium link owners that their there link has expired:

This email can be customized when in the Control Panel >> Plugins >> Premium Link Manager >> Expiry Emails - (Note that you have to use a CRON program to send out emails. See the '10.1.6 Expiry Emails' for more on this)

 

10.3 Sending Email to Premium Link Owners

To send email to premium link owners go to the Control Panel >> Plug-In's >> Premium Link Manager >> Send Email to Premium Link Owners

You will be provided with the following options:

From Email Address
This is the email address from which you will be sending email to premium link owners.

From Name
The email will be sent from this name. You can specify your name or company name here.

Subject
This will be the subject of the email.

Message
This will be the email message that will be sent to premium link owners. You can personalize this email by using variables inside the message.

You may use the variables (words) as listed below inside the email message. It will be replaced by for examples the names and details of premium links.

%%title%%
This will be replaced by the title of the link.

%%description%%
Replaced by the description of the link.

%%keywords%%
Replaced by the keywords of the link.

%%url%%
Replaced by the URL of the link.

%%name%%
Replaced by the name of the contact person for the link.

%%rating%%
Replaced by the rating of the link.

%%votes%%
Replaced by the votes the link has received.

%%hits%%
Replaced by the hits (clicks) the link has received.

%%expiry_date%%
Replaced by the date when the premium link expires

Only send email to link owners who ticked the subscribe box when they made a submission.
When a premium submission is made there is an option to tick a subscription box. If you select this option to only send email to link owners that checked this box then only email will be sent to them.

Prevent duplicate emails
Note that owners of multiple premium links will only receive one email if this box is checked.

Only send email to link owners who's premium link expired - If this box is not checked then email will only be sent to existing premium link owners. (Links that are premium links that has not expired.)
Only send email to premium link owners who's premium link expired.

Number of Emails to Send at a Time
The mailer will only send this specified amount of emails at a time. Setting this value too high might overload your mail server. Sending only a limited amount of email messages at a time will avoid overloading of the mail server.

Sending a Test Email
You can fill in this field with your own email address to send yourself a test message to see how the message will look like when users receive it. When you send yourself a test email then no users will receive the message. The message will only be sent to yourself.

 

10.4 Retrieving Email Addresses of Premium Link Owners

This option allows you to retrieve the email addresses and link details of Premium Link Owners. This can come in handy if you would like to export premium link details or if you would like to use a third party mailing client to send email with.

 

10.5 Customizing Premium Link Email Responses

Welcome Email
This email will act like an auto responder when an end-user submits a premium link. You can customize it by going to the Control Panel > Plug-Ins > Premium Link Manager > Welcome Email

New Premium Submission: Acceptance Email

This email is sent to a user when his new premium submission has been approved for inclusion into the directory. You can customize it by going to the
Control Panel > Plug-Ins > Premium Link Manager > New Premium Submission Acceptance Email

New Premium Submission: Rejection Email

This email is sent to a user when his new premium submission has not been approved for inclusion into the directory. This might be due to non-payment or other reasons. You can customize it by going to the
Control Panel > Plug-Ins > Premium Link Manager > New Premium Submission Rejection Email

New Premium Submission: Informer Email

This email is sent to you, to inform you that a new premium submission has been made. You can customize it by going to the Control Panel > Plug-Ins > Premium Link Manager > New Premium Submission Informer Email

 

10.6 Expiry Emails

Note that these emails are only sent when you have a scheduler program or the Unix CRON program set up to execute the script that sends these emails. The script needs to be run or be executed on a daily scheduled bases. See 10.1.7. below to see how to configure this.

 

10.7 Sending Expiry Emails to Premium Link Owners Who's Premium Links is About to Expire

You will need to execute exp_emails.cgi on a daily basis to be able to send out emails to premium link owner's who's premium links are about to expire. You will normally want to use the Unix CRON program to accomplish this. Many hosting companies provide options to use the Unix CRON program. The Unix CRON program is a scheduler which will execute files on a scheduled basis. (Once a day or any time interval you specify)

Note that you cannot just execute exp_emails.cgi with the Unix CRON program. The reason for this is that exp_emails.cgi needs to be executed in the working directory where it resides.

To make the directory in which exp_emails.cgi resides in, the working directory, you can create a Unix shell script, (Almost like a dos batch (.bat) file) that executes generate.cgi

The shell script should look something like this:

cd /home/yourdomain/www/cgi-bin/admin # Change to exp_emails.cgi working dir
perl exp_emails.cgi
# Execute exp_emails.cgi

Note that a shell script is a normal text file that you create and upload to your web host or server. Also note that you will most likely need to assign executable permissions to it (permissions of 755) - Click here to find out how to set file permissions.

 

10.8 Browsing and editing premium links.

You can browse/view/edit premium links by going to the Control Panel >> Plug-Ins >> Premium Link Manager >> Browse/Edit Premium Links

Note that premium links will also always be listed first in categories inside the Directory Manager for editing/moving/copying/deleting. Premium links will also always be indicated where-ever it is listed in the PowerSeek SQL Control Panel.

 

10.9 Customizing Premium Link Templates

The functionality explained here allows you to customize premium link displays so that they are differentiated from standard links. You can for example display premium links with a 'sponsored' graphic or even a photo where standard links does not have this. To customize premium links go to the Control Panel >> Template Manager

Go to the following locations to customize the premium link style templates:

Category Premium Link Displays:
To customize the template used for premium link displays in categories edit the templates:
Control Panel >> Template Manager >> 1. Default Category/Directory Templates >> Premium Links Style

Control Panel >> Template Manager >> 1. Default Category/Directory Templates >> Link Info Premium

    The 'Link Info Premium' template is used to display premium link details. This template is used to display premium link details when a visitor clicks the 'more info' link from a premium link.

Premium Links displayed in Search Results:
To customize the template used for premium link displays in search results edit the template:
Control Panel >> Template Manager >> 2. Search Result Templates >> Premium Links Style

Premium Links displayed from the What's New section:
To customize the template used for premium link displays in the What's New section edit the template:
Control Panel >> Template Manager >> 6. What's New Templates >> What's New Listings Premium Style

Premium Links displayed from the Top Hits section:
To customize the template used for premium link displays in the Top Hits section edit the template:
Control Panel >> Template Manager >> 6. What's New Templates >> Top Hits Listings Premium Style

Premium Links displayed from the Favorites section:
To customize the template used for premium link displays when a user views his/her favorites selected, edit the template:
Control Panel >> Template Manager >> 9. Favorites >> Favorites Premium Link Style


Also See:
6.2 Template Customization Basics
6.3 Template Basics
6.4 How to edit templates
6.6 How to use images in templates
6.8 General Template Guidelines
6.11 How to use custom directory templates (With this functionality different categories can have different premium link styles)
11.3.1 Premium Link Manager
12.3.3 How to display and let submitters upload multiple images with link listings

 
<< Previous Page
Maintenance.
Index Next Page >>
Plugins
PowerSeek SQL Web Directory Software - Web Directory Script
Features | Demos | Examples | Download | Buy Now | Documentation | Affiliates | Support | Hosting | Contact Us | Login | Site Map
Pre-Sales Questions | Upgrade from Turbo Seek | Knowledge base | PowerSeek PPC Module
FocalMedia.Net