Demo RevMax Plugin for OpenX

Questions about openx adserver plugin RevMax?

RevMax OpenX Plugin Features

Recent Posts

Pages: [1] 2 3 ... 10
1
Advertisers Signup / Using OpenX Plugin With WordPress
« Last post by btdsoft on May 15, 2012, 11:27:26 PM »
I get asked in email often on integrating the RevMax enrollment pages with a wordpress theme. As it is a "OpenX Plugin", and not a word press plugin it is not as simple as one would think, but can be done.

First if you have the encrypted source, there is no way of changing the images url for paypal or other payment processor, so you must include the images directory or create one with the image you wish to use above the signup form. This can be done as in the current OpenX Plugin /clients/images, enroll/images, whatever you choose to use, but it must remain "images". You can then determine what image you are trying to replace by viewing source or other method and simply overwrite it with your new file of the same name.

No matter where the signup page is, as long as there is a /images folder above it, with a image correctly named, it will show.

Be warned you cant forward a signup through a word press page or post, RevMax is not a word press plugin. The best you will accomplish is a popup and I don’t believe it will look nice or paypal will accept it.

The way to do it in word press is use your wp template on the form, and  use the
"page-links-to" plugin and then the signup page is still in its own directory, with a
images folder, like "mydomain/enroll/advertisers.php"


To do this you can simply create a new page in your wp, then go to it > right click> view source> save as template.php or whatever. You can then strip out what you dont want or not and insert the signup form in the content area of the new page or post you created for a template. (dont forget to delete it after you have the source). You must also include the css files and the wforms files unless you are doing your own error messages.

To include the form(s) in any php page simply use a include_once statement such as bellow.

twentyeleven example:
Code: [Select]
<div id="main">
<div id="primary">
<div id="content" role="main">

<?php include_once ' advertisers.php';?>

</div><!-- #content -->
</div><!-- #primary -->
</div><!-- #main -->

You must also make sure the include paths are correct at the top of advertisers.php
Code: [Select]
<!--Start signup-->
 <?php
 
//init tells us where we are at
 
require_once '../init.php';
 
// nothing works without functions
require_once MAX_PATH '/www/admin/plugins/RevMax/lib/RevMax.functions.php';
require_once 
MAX_PATH '/www/admin/plugins/RevMax/lib/PaymentRouter.php';
 
// clients language is editable or edit all text here and remove call.
include'clients.lang.php';

If these files are not properly included, the form or functions will not work.

Hope that helps for any of you stuck out there.
2
Authorize.net Payments / Re: Timeout- Error Message from Authorize.net.
« Last post by btdsoft on November 02, 2010, 06:01:31 PM »
I believe this was solved as per;
"Check that your script permissions are correct and that it can accept a HTTPS POST."

Let me know if anyone else experiences a problem with authorize.net

http://openxpayments.com/revmax-installation/redirect-loopno-revmax-tab-access-at-all-404-error/msg100/#msg100
3
3rd Party Integration / Adding third party payment processors.
« Last post by btdsoft on May 04, 2012, 11:25:04 PM »
RevMax currently includes paypal, authorize.net, 2checkout, and worldpay payment processing for advertisers purchases. If you have a need to use another processor, it may be a simple matter as there are two options.

1) The authorize.net scripting is compatible with many other processors with little or no changes.
2) Use the included example found at;
openx/www/admin/plugins/RevMax/lib/router_example.php

then replace the current PaymentRouter.php with your modifications.

router_example.php
Code: [Select]

// Include the 3rdparty library
include_once ('3rdparty.php');

// Create an instance of the 3rdparty library
$my3rdparty = new 3rdparty();

// Specify your 3rdparty email
$my3rdparty->addField('business', 'YOUR_3rdparty_EMAIL');

// Specify the currency
$my3rdparty->addField('currency_code', 'USD');

// Specify the url where 3rdparty will send the user on success/failure
$my3rdparty->addField('return', 'http://'.$_SERVER['HTTP_HOST'].'/payment/3rdparty_success.php');
$my3rdparty->addField('cancel_return', 'http://'.$_SERVER['HTTP_HOST'].'/payment/3rdparty_failure.php');

// Specify the url where 3rdparty will send the IPN
$my3rdparty->addField('notify_url', 'http://'.$_SERVER['HTTP_HOST'].'/payment/3rdparty_ipn.php');

// Specify the product information
$my3rdparty->addField('item_name', 'AdPackage-1');
$my3rdparty->addField('amount', '99.99');
$my3rdparty->addField('item_number', '001');

// Specify any custom value
$my3rdparty->addField('custom', 'custom');

// Enable test mode if needed
$my3rdparty->enableTestMode();

// Let's start the train!
$my3rdparty->submitPayment();

The payment ipn files are unencrypted and you can easily modify any found in
/plugins/payments or create your own using them as examples.

You can further modify the RevMax plugin interface screens to include your changes by modifying a existing one or adding your own xml files as seen in openx/plugins/etc/AuthNet ,
or openx/plugins/etc/PayPal

4
RevMax publisher sign up functions. / Publisher Enrollment and Approval
« Last post by btdsoft on May 04, 2012, 08:39:18 PM »
RevMax allows for the enrollment of publishers and the automatic creation of zones and permissions assignment.

To enroll a publisher simply send them to /openx/clients/publishers.php to fill out the enrollment form.
The form is highly modifiable and any fields can be left off the form by removing them and inserting a hidden field input such as;
Code: [Select]
<input type="hidden" name="postcode" value="not-required">
Further fields can be modified as shown within the form;
Code: [Select]
<!--edit states / provinces in clients.lang.php-->
Code: [Select]
<!--edit categories in clients.lang.php-->
Note adding other categories to the list not seen within Admin >publishers > create zone view may cause problems as the category list is retrieved from the openx.org servers. Removing categories from the signup list should pose no problems, nor should making it a hidden field as long as there is some input.


Once a new publisher has completed the enrollement process he is presented with a thank you page located within /openx/www/admin/plugins/RevMax/templates/thankyou.php. For more information on modifying this view please see this topic. The administrator is then sent a email notifying them of a new publisher enrollment in OpenX.

The new publisher can then be located within OpenX > working as Administrator > RevMax tab > Pending Publishers. From this view you may view, delete or approve the newly enrolled publisher.


To view the newly enrolled publisher info click view;


To delete the pending publisher simply click delete, then confirm delete on the next info overview page.

To approve newly enrolled publisher, click approve. Here you are prompted with more options;


Publisher approval options;
1) Check To Create Standard Publisher Zones Select Sizes Below;
 If you would like to create new standard sized zones for the publisher check this box.

2) Select Standard Zones To Be Created For Publisher;
 If the box above was checked any sized zones checked here will be automatically generated for the publisher when you clcik submit. You have 6 options at this point.
a) 160 X 600, b) 120 X 600, c) 300 X 250, d) 728 X 90, e) 468 X 60, f) 125 X 125.

3) Enter Zone Id To Be linked To New Publisher Zones;
Note:counter intuitive; This function allows for zone chaining, enter in here any existing publishers zone that you would like to chain this new zone to as seen in publishers zone > advanced.
   
 Here you can link a existing publishers zone(s) to the newly created publishers zones created in step 2 above. Simply enter in the publishers zone id number here. Caution The new publisher will not have stats available to him here, only the publisher with the original zone that was chained to in this step.

4) Select Permissions To Grant Publisher;
 Here you can assign the permissions level for the newly created publisher. With none checked the publisher may log in, but do nothing other than update his info or view stats. To assign more privileges check boxes as needed.
a) Create New Accounts; allows the publisher to assign new users to his login account.
b) Modify His Own Zones; This allows a publisher to make changes to his existing zones.
c) Define New Zones; Allows the publisher to create new zones.
d) Delete Existing Zones; Allows publisher to delete any zones in their account.
e) Link Banners To Own Zones;  Allows the publisher to view and link advertisers banners and campaigns to their publisher zones.
f) Generate Invocation Code; Allows the publisher to generate new invocation code for thier existing zones.

A basic permissions set would be f) Generate Invocation Code. This allows the publisher to view stats, and generate new invocation code. They will not be able to link or unlink any advertisers banners or campaigns from thier zones, nor add new user log ins.

5) Check To Send Custom Email And Modify Below Template ;
 By checking this box you may send the newly enrolled publisher a custom welcome email. Simply remove or edit the text in the box below, and add you own. If this box is not checked the existing welcome template will be used. More on customizing email templates here.




5
Advertisers Signup / Customizing advertisers and publishers emails
« Last post by btdsoft on May 04, 2012, 06:22:14 PM »
RevMax sends emails to welcome new advertisers and publishers. The templates are located in;
openx/www/admin/plugins/RevMax/templates

In this folder you can find the file "email-help.txt" that has the information;
Quote
List of generated names you can use in your email templates.
** Advertisers welcome ***
[ADMIN-EMAIL]  admin email configured in paypal settings.
[SITENAME]  your OpenX installation name
[SUBJECT]  subject of message
[EMAIL]   users email submitted
[CLIENTNAME]  name submitted in form
[LOGIN]   url to log in
[USERNAME]  login name
[PAYMENT]  payment amount
[PACKAGE]  package name bought


** Publishers email templates **
Site name:[SITENAME] --Configured in administrator account >my account> global settings> user interface settings.
Admin email: [ADMIN-EMAIL]   configured in RevMax > paypal settings > admin email
subject: [SUBJECT]     publisher account approved
Publishers email:[EMAIL]    email used during signup
Publishers name:[AFFNAME]    name submitted during sign up
Publishers username:[USERNAME]   chosen username
Publishers id:[PUBID]     publisher id assigned within openx
Log in url:[LOGIN]       log in url configured in revmax > paypal settings

 Awelcome.tpl is the template sent to a new advertiser after they have completed payment when the system is automated, or when the openx admin approves the account. It has basic instructions to the advertiser for uploading banners, and creating campaigns.

 Admin.tpl is the template used when a email is sent to the openx admin when a advertiser has made a purchase by restocking their account with ad views or ad clicks or creating a new campaign.

 newcampaign.tpl Is the email payment record sent to advertiser when a advertiser purchases a new campaign.

 Pwelcome.tpl Is the template sent to a new publisher when approved by the openx administrator. This template can be overridden when approving a new publisher by clicking
"send custom email" in the second step of approving a publisher and creating campaigns
zones for them in RevMax admin.

 refill.tpl Is the email sent when a advertiser restocks a existing campaign by purchasing more ad views or ad clicks.

 thankyou.php Is the template used for the thank you page upon a publishers signup.

Any payment emails / templates may be overridden within /openx/plugins/paypal_ipn.php
by replacing the $_SESSION['Template'] location / name.

Any questions, please ask.


6
As many will seek to use OpenX as a network adserver, they may wish to make some basic changes to the look and feel to incorporate it into their existing theme or look.


Basic image changes;
Images found within /openx/www/admin/assets/images/
To change the login OpenX logo you can replace logo.png  , logo-adserver.png.
To change the logo seen when generating website spc tags, replace logo-wtag.png
To change the banner watermark on spc page, replace watermark.gif

Making name changes in /openx/constants.php
To change the zone invocation tag naming change the txt of line # 42
To change the location of help files change line # 45 & 47
To change the forum url change line # 49

Code: [Select]
// Define this version of Openads's constants
    define('OA_VERSION', '2.8.8');
    define('MAX_PRODUCT_NAME',      'OpenX');
    define('MAX_PRODUCT_URL',       'www.openx.org');
    if (preg_match('/^(\d+\.\d+)/', OA_VERSION, $aMatches)) {
        define('OX_PRODUCT_DOCSURL',   "http://www.openx.org/help/{$aMatches[1]}");
    } else {
        define('OX_PRODUCT_DOCSURL',   "http://www.openx.org/help");
    }
    define('OX_PRODUCT_FORUMURL',  'forum.openx.org');


Hope this helps.
7
RevMax Publisher Payments / Re: Revenue Publishers Sharing
« Last post by btdsoft on January 18, 2012, 10:54:03 PM »
I believe with good math, you can when you set up the campaigns and zones. This would have to be done using the openx report generation feature.

OpenX has a lot of nice features such as reporting, once you become familiar with its usage. Optionally you could perhaps tie into these feature with third party scripting.

One of the biggest problems was with the plugins interface release back when, the standard logging was ripped apart and why the country does not show in conversion reporting now. Others have made add ons or code hacks to accommodate this, however if you can read code, basically putting the logging back into 1 plugin fixes these issues.

I was about to create a plugin with more / better reporting features, however lost interest in it. If / when I ever get back to it, I hope to have all this within a word press plugin, and removed from OpenX.

Sorry late reply, been going thru a nightmare sickness here, as soon as we start to feel better, we (family) begin spontaneous vomiting and back to bed. Today fever and chills.


Mike
8
RevMax Publisher Payments / Revenue Publishers Sharing
« Last post by openx1210 on January 18, 2012, 02:27:31 AM »
hi

it's there a way to set a percentage of revenue publisher sharing. for example, publisher receive 70% and i received 30% from Advertiser.
9
General Discussion / Re: Allow only 1 ip to click every 24hr
« Last post by btdsoft on January 17, 2012, 05:36:10 AM »
I see what you are saying, just OpenX not counting.
Perhaps a small include script that ads ip to dont track records, then removes every hour.
Probably pretty easy. Biggest problem, kept in config and not db.

here is the flow if someone wants to do it:

include script writes clicked ip to var/domian.config.php
[logging]
ignoreHosts="ipn.umb.erh.ere"

settings set to 3600 seconds. ignores for 1 hour.
openx/www/admin/account-settings-banner-logging.php

this should do as you need, can add more to delete as it might get big fast.

Cant think of another way right now.
Mike
10
General Discussion / Re: Allow only 1 ip to click every 24hr
« Last post by openx1210 on January 16, 2012, 05:09:05 AM »
hi mike

perhaps you misunderstand me Mike, the user can still click on the ads but it does not count as click. this is because, only one ip can count within 24hrs. the same users can clicks as many ads they like.

this mods will bring  high quality traffic to advertiser. less bounce rate, more time in their site and surely enough, they will come back to advertise in your site again.



 
Pages: [1] 2 3 ... 10