< Back to Sponsorship

Listing type Sponsorship

You can use listing type sponsorship to let people purchase a more eye-catching link, or show them in a special place that regular listings aren't shown.

First, fill out the general settings at the top of Admin Panel -> Revenue -> Sponsorship. You can use any of the three supported payment processors -- PayPal, 2checkout and nochex -- or you can leave all three of those fields blank and process payments manually.

Click the "Add Link Type Sponsorship Level" link to add a level. Follow the instructions on screen. If you want to use a new listing type you'll need to set that up at Admin Panel -> Listings -> Link Types first. After adding the sponsorship level, you'll see the levels you've created listed on the sponsorship settings page for you to edit.

If you want to require all listings to be sponsored, just set up sponsorship levels for all the listing types you have.

You can customize the payment buttons and the rest of the payments page at Admin Panel -> Themes -> Manage Templates -> "Sponsor Purchase - Link Type". You can set the price in the paypal button to whatever value you want, and that amount will be credited to the account on purchase, and deducted at the rate specified by your sponsorship settings. In other words, feel free to have people buy in $100 quantities even if you want to deduct at $1/day.

Prompts asking people to sponsor their listings will automatically appear on the details page, member home and submit listing page.

Displaying on Submit Listing

By default, the details of your prices are displayed on the 'submit listing' and 'sponsor purchase - listing type' templates. If you wish to display the info in other templates, such as the 'show listings in category' template, you can do so with this code:

<ul>
<!-- BEGIN SPONSORED LIST -->
<li>{TYPENAME} costs {PRICECURRENCY} for {DURATION} {SPONSORLEVELDURATIONLANG}.</li>
<!-- END SPONSORED LIST -->
</ul>


The available template variables in the SPONSORED LIST segment are:
{TYPENAME} - The sponsorship level's label
{PRICECURRENCY} - The price with currency symbol
{PRICE} - The price without a currency symbol.
{DURATION} - The number of days/weeks/months/years the sponsorship is for.
{SPONSORLEVELDURATIONLANG} - days, weeks, months or years -- whichever is applicable
{DESCRIPTION} - The description you entered for the sponsorship level.

Displaying on the Sponsorship Template

In your "Sposnor Purchase - Link Type" template, There's a <!-- BEGIN LEVELS --> ... <!-- END LEVELS --> segment which displays the info about each sponsorship level. The available template variables within that are:
{SPONSORLINKTYPE} - The official name of the listing type which this level promotes listings to.
{SPONSORLINKTYPELANG} - The friendly display name of the listing type which this level promotes listings to.
{SPONSORCHARGE} - The price without currency.
{SPONSORCHARGECURRENCY} - The price including currency symbol.
{SPONSORITEM} - The item number of the sponsorship level, where applicable.... but this is auto-calculated now and generally you shouldn't pay attention to it.
{SPONSORLINKFEEDURATION} - The number of days/weeks/months/years
{SPONSORLEVELDURATIONLANG} - days/weeks/months/years (whichever is applicable)
{SPONSORLEVELDESCRIPTION} - The description you entered for the level.
{SPONSORLEVELDESCRIPTIONESCAPED} - The description you entered for the level, with all tags removed, trimmed to 200 characters, for the sake of complying with paypal's display rules.‚Äč
{SPONSORLEVELDESCRIPTIONBOOL} - For use in conditionals, this returns true if there is a level description and false otherwise.
{SPONSORLINKSUBSCRIPTION} - For use in conditionals, this returns true if it's an auto-renewing subscription and false otherwise.

Changing Sponsorships

When someone sponsors a listing, their listing gets promoted and an expiration date for the promotion is set. Changes to sponsorship settings won't affect the expiration date. This means you're free to alter the price of a sponsorship level without affecting already-sponsored listings. Once the listing comes up for renewal, however, the owner will have to pay the new price to re-sponsor it.

The exception to his is pay-per-click sponsorship, which will deduct funds at the rate of the moment.

Bulk Sponsorships

See Bulk Sponsorships to learn how to let people purchase listing type sponsorships in bulk with optional discounts.

Notes

To learn how to test paypal using paypal's sandbox with WSN, see this article.