Installing RevMax for openx 2.6

September 15, 2008 · Posted in OpenX Plugins

Installing and configuring RevMax 3.0 for OpenX 2.6

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.

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.

btdsoft.com