Building on the base OpenX advertiser signup features of RevMax 3, I have added another payment processor worldpay, with the ability to more easily integrate multiple websites, Reorder packages and more.  You can view all RevMax features and demo here.

WorldPay Payments now supported

RevMax now offers the ability to enable both Paypal payments and Worldpay payments, selling adclicks, adviews, or subscription packages. Advertisers may sign up using either payment processor. You can enable one or both processors to accept payments in your desired currency. Authorize.net comming soon!

Advertiser s may signup with monthly subscriptions renting banner spots on your website using futurepay payments by worldpay, and paypal ipn subscriptions.

Easily Integrate multiple sites

I have moved the return url into the ad packages, so with any ad package you create you can now send the user back to that domain after purchase. This makes hosting a sign up form on one domain, and the ad server on another transparent, simply create your form, and post it to your clients.php and the advertiser can signup and make payment and be returned to the desired location after payment for that package.

Create a top ten sponsored Links list

I have added the ability to add a amount of available ad package when created. As advertisers signup in openx, the number of available ad packages will go down with every sale. This will allow you to create a top ten sponsor list, top links etc, on your site and when all spots are filled the package is no longer available. This feature is useful when building a website such as seen here http://www.scratchback.com/ (no affiliation).

Re Order packages

You now have the ability for advertisers who have signed up to purchase more adviews or adclicks to replenish their account. With further mods to the clients campaigns page, when a set number is reached (admin configurable), a reorder link appears and the advertiser can add adclicks or adviews to their account at any time depending on account type. When the adclick / adview value reaches 0 the advertiser can then make a choice to purchase more ad clicks or ad views to the account and is not restricted to adding just adviews if it was originally a adview account.

Advertiser banner upload script mods

I have further modified the included advertiser banner upload mod for openx 2.6 . Now the user has the ability to upload new banners to their campaign, edit existing banners, and delete existing banners. I have also made it to where none of these links appear unless admin gives banner modify permission. This ensures there are no longer any permission denied screens as with the before mods.

Note All advertisers who sign up with RevMax will automatically gain these permissions upon payment completion and account creation. If you do not want your clients to be able to modify, delete, or add banners, do not use the included banner upload mod.

States / provinces now moved into clients.lang.php to ease in editing states provinces

RevMax is constantly growing and being updated to be the best advertiser signup plugin for openx. RevMax includes at no additional cost, features other vendors charge extra for, while including no updates and limited support. Take a look at all the existing features of RevMax and you will see why it is the #1 choice advertiser signup and payment plug in for the OpenX ad server.

This post assumes you have purchased and installed RevMax 3 for OpenX 2.6 .If not you can get more information and purchase it here.

Navigating to RevMax Ad Packages

Open a browser and log into your OpenX install and switch to Administrator.
Click the RevMax tab at the top right of screen.

Next click the Ad Packages tab to open the ad packages list screen. Here you can explorer already created packages, add a new advertising package, edit an existing one, or delete a no longer used one.

From the Ad Packages list screen click on “Add Package”. This will open the below screen to create your first advertising package within Openx.

Configuring The Ad Package.

You must first have some idea as to what type of advertising package you would like to sell or ad space you would like to rent.
Lets go over the settings.
a) Selling: Would you like to sell Ad Views (cpm), Ad Clicks (cpc), or rent a tenancy ? Select accordingly from the drop down list.
b) Package Description: This will be shown on the drop down select list on the advertisers signup screen if made public later in settings. If you are selling 10,000 adviews as a leader board on domain.com then enter in something like 10,000 LeaderBoard Adviews at domain.com.
This field combined with the later discussed “make public” field is handy for creating ad packages across a network of sites.
c) Duration: Enter in here the amount of ad views, ad clicks or the actual time as in subscription. Example if selling 10,000 ad views enter 10000 notice no comma. If selling a subscription simply enter UNLIMITED, or 30 days etc.
d) Cost: Enter in here the amount you would like to collect using paypal for this ad package. Enter numbers like 100.00, do not enter in $ or other signs like “,”.
e) Auto Zone ID: Use this field if you would like to link an advertiser campaign to a specific publishers zone within OpenX. Notice the scrolling iframe to the right. Here you can scroll and find a zone id easily without clicking back and fourth through OpenX. The iframe list the zone id number (to be used) the zone description you have entered when creating the zone within OpenX, and the size of the created zone. This feature is extremely useful when selling ad space across a network of sites. For instance a package for domainb.comcom’s leader board can be easily linked here.
f) Auto Zone: Select yes or no to allow advertisers banner to be automatically attached to a specific zone. This is useful if you are renting a spot 160X600 on the index page and you have a zone created within openx for this. Create a package named 160X600 skyscraper etc, and link the package to this zone. the advertiser will not be able to show a banner unless it meets the zone requirements (160X600), as he has no permissions within OpenX to link banners to another zone.
g) Priority Level: You can choose to set a higher priority for paid campaigns here. Keep in mind that high priority campaigns will override any lower level campaigns that may already be active. A high setting number here may deactivate lower priority existing campaigns, once the advertiser or you have added a banner to the campaign.
h) Weight: If you chose to leave the priority setting at the default of “0″ above you can enter in a higher weight here if necessary. For example if your “house” campaigns are at a weight of 1 then a setting of 2 here will give this advertisers campaign a higher weight and more exposure, yet the house campaigns will still receive exposure.
g) Make Package Public: Here you can decide if you would like the created package to be shown on the advertisers sign up screen if using the included sign up form.

This may be used in a number of ways. example a: If you are selling ad space on domain b and you do not wish the package available on domain a then set to no. you can then create a link to another sign up page for this specific package. simply go to the existing sign up form, view source , save as filename.html, and edit the available packages list to include the desired package description and package id number. You can then use this form to post to domaina.com/clients/clients.php and the user will be forwarded directly to paypal for payment.
You may also create a totally custom form or button for this package, as long as all the required information is passed to clients.php . If you do not desire all the information, then simply include null values in hidden fields within your new form. Be aware that all information gathered by clients.php is used within OpenX. Example: If you decided not to use clients domain url. The url is set as the campaign name within OpenX by RevMax so you would then have campaigns named “NULL”.

This post assumes you have downloaded RevMax 3 and unzipped it to your local computer.
If you do not have RevMax you may get more information and purchase it here.

RevMax is encoded with Ioncube and will require ioncube loaders installed on your server to function. If you arent sure you can download the Helper.zip file and upload to your server for more information and or installing the loaders. Indepth instructions on installing ioncube loaders can be found here.

Installation

1) Open a ftp client such as wsftp or other and sync the downloaded files and your OpenX installation on your server.
2) Upload all files in the directories as shown in the install package in binary mode.The files are encrypted using Ioncube loaders and will not run in ascii mode.

It is safe to highlight all files and folders as shown above and transfer contents without transferring each individual file.

3) Navigate in a web browser to yourdomain /openxfolder/ installsql and run the script there named revmax.db.installer.php. This will install the required tables for RevMax to operate.
a) If you would prefer to verify and or change the table names to be inserted into your OpenX database, open the file “db.mysql.sql” and edit if needed. You may then use the install script or copy and paste the sql into your phpmyadmin screen or other mysql admin.

Logging In to Set Up RevMax

4) Log into your Openx 2.6 Installation. And switch to administrator mode. You will not be able to view or modify RevMax settings while working in default, or other manager mode.

You will then be able to see the RevMax tab at the top right of your admin screen.

Click the RevMax tab to navigate to RevMax. There you will see a RevMax updates page, with news of any product updates, and 4 new RevMax tabs, entitled “RevMax Settings”, “Ad Packages”, Discount Coupons” , and “Payment Reports”.

RevMax Configuration

5) Click the “RevMax Settings” tab to get started configuring RevMax. Here you will find two links labeled RevMax “Database Settings” and “Paypal Settings”.

Configuring The Database

6) Click the “RevMax Database settings” link to configure the RevMax database.
While here you will need to tell RevMax what the table names are that it will be working with. The default installed tables are listed to the left. It is safe to simply copy and paste the names into the settings boxes unless you have chosen to rename the tables after installing them. Remember to enter in any new table names you may choose later.
Hint: Your config file must be writable to add RevMax database and paypal settings.

7) Once you have entered the database table names, click “Revmax Settings” tab again and choose the “paypal Settings” link. From this screen you can enter in your paypal settings as outlined below.

Configuring Paypal IPn Payments

a) Paypal email : This is the email where you will accept paypal payments recieved by RevMax.
b) Payment Admin eMail: The email address you would like script notifications sent to.
c) Paypal Url: You may set this to www.paypal.com or www.sandbox.paypal.com or other testing domain / script. The https: is handled within RevMax leave it out.
d) Paypal IPN Script URL: The paypal script is located within the clients folder. depending on your Openx install it may be yourdomain.com/openx/clients/paypal.php or yourdomain.com/clients/paypal.php, or other.
e) Paypal Return URL Location: This is the url that a user will return to after clicking return to merchant at paypal. You may set this to your openX admin folder or create a page in another location, giving clients more information and or a log in link. You may also use a custom script at this location as paypal will post back the information it received.
f) Cancel Payment Return Url: Enter in here the url you would like the customer to be returned to if the payment was canceled.
g) Client Log In URL: This is the client log in url sent in the customers welcome email. You can simply set this to /www/admin/ for instant login after payment, and banner upload if using the banner upload mod.
h) Payment Currency: Set htis to the currency you will be accepting USD for united states dollars.
Note: Language location in (i) must match or you will recieve errors.

Other Available Currency settings:
• AUD Australian Dollar: $12,500.00 AUD maximum per transaction
• CAD Canadian Dollar: $12,500.00 CAD maximum per transaction
• EUR Euro: €8,000.00 EUR maximum per transaction
• GBP Pound Sterling: £5,500.00 GBP maximum per transaction
• JPY Japanese Yen: ¥1 million JPY maximum per transaction
• USD U.S. Dollar: $10,000.00 USD maximum per transaction
• NZD New Zealand Dollar, 15,000 NZD maximum per transaction
• CHF Swiss Franc, 13,000 CHF maximum per transaction
• HKD Hong Kong dollar, 80,000 HKD maximum per transaction
• SGD Singapore Dollar, 16,000 SGD maximum per transaction
• SEK Swedish Krona, 80,000 SEK maximum per transaction
• DKK Danish Krone, 60,000 DKK maximum per transaction
• PLN Polish Zloty, 32,000 PLN maximum per transaction
• NOK Norwegian Krone, 70,000 maximum per transaction
• HUF Hungarian Forint, 2,000,000 maximum per transaction
• CZK Czech Koruna, 240,000 maximum per transaction

i) Seller Language Location: Set this to match your accepted currency and language. Usually abbreviated, if paypal currency = GBP then language location would be GB.

Subscription Recurring Values
a) Subscription billing cycle: If renting ad space by the month set to 1, you may also sell ad spaces for increments like 6 months.
b) Subscription billing Unit: W= Weeks, M= Months, Y= Years. Enter in here the cycle you will be using. Example renting ad space for 2 weeks would be billing cycle = 2 unit = W.
c) Subscription recurring: 1 = Yes to recur 0 = no not recur bill the client.
d) Re bill re attempt: 1 = Yes 0 = No to force retry on failed subscriptions.
Enable Paypal Payments
Check the box to enable RevMax to accept paypal payments, before clicking submit.

You should now have RevMax configured to accept Paypal payments for OpenX 2.6. Stay tuned for next post entitled configuring ad packages and discount coupons. If you do not have RevMax you may get more information and purchase it here.

See also: Installing and configuring the included advertiser banner upload mod for OpenX 2.6 And configuring ad packages within Openx here.