Allocation Schedule ' . $id . '
Follow Mobile Sentience';
private $DonateImage = '';
private $DonateText = 'Donate';
private $TwitterFollow = 'Follow Mobile Sentience';
private $FacebookFollow = '';
private $AdminTabs = array(
'campaigns-tab' => array('name' => 'Campaigns', 'method_base' => 'CampaignListTab'),
'sources-tab' => array('name' => 'Local Ads', 'method_base' => 'SourceListTab'),
'settings-tab' => array('name' => 'Settings', 'method_base' => 'SettingsTab'),
/*'handbook-tab' => array('name' => 'Tutorials', 'method_base' => 'HandbookTab'),*/
'support-tab' => array('name' => 'Support', 'method_base' => 'SupportTab'),
'about-tab' => array('name' => 'About', 'method_base' => 'AboutTab')
);
private $AllocationMap = array(
'name' => 'alname-',
'description' => 'aldescription-',
'displayed' => 'alpaneldisplayed-',
'ads' => array(
'advertisement' => 'alad-',
'weight' => 'aladweight-',
'percent-weight' => 'aladpercentweight-'
),
'rulesets' => array(
'id' => 'alrulesetid-',
'rules' => array(
'type' => 'alruletype-',
'author' => 'alruleauthor-',
'posttype' => 'alruleposttype-',
'tag' => 'alruletag-',
'category' => 'alrulecategory-',
'post' => 'alrulepost-',
'page' => 'alrulepage-',
'argname' => 'alruleargumentname-',
'argvalue' => 'alruleargumentvalue-',
'argop' => 'alruleargumentoperator-',
'catid' => 'alrulecategoryid-',
'catop' => 'alrulecategoryoperator-',
'tagid' => 'alruletagid-',
'tagop' => 'alruletagoperator-',
'vpath' => 'alrulevpath-',
'vpathop' => 'alrulevpathoperator-',
'cvarname' => 'alrulecvarname-',
'cvarop' => 'alrulecvaroperator-',
'cvarvalue' => 'alrulecvarvalue-',
'geolocation' => 'alrulegeolocation-',
'geoop' => 'alrulegeoop-',
'geovalue' => 'alrulegeovalue-'
)
)
);
private $RuleTypes = array (
'author' => 'Match an author',
'posttype' => 'Match the post type',
'category' => 'Match a category',
'tag' => 'Match a tag ',
'geoip' => 'Match a location',
'getargument' => 'Match link arguments'
);
private $VirtualThemeRules = array (
'vpath' => 'Match a Virtual Path',
'cvar' => 'Match a Virtual Theme Custom Variable'
);
private $CacheTimes = array(
'0' => 'Never Cache',
'1' => 'Save loaded data for 1 hour',
'24' => 'Save loaded data for 1 day',
'168' => 'Save loaded data for 1 week'
);
// Protected constructor for singleton
private function __construct(){
/** Uncomment for testing, forces loading of plugin stylesheets and javascripts */
global $pluginversion;
global $pluginname;
$this->version = $pluginversion;
$this->name = $pluginname;
$this->adserv = 'http://www.mobilesentience.com/ads/WordpressPlugins&plugin=' . $this->name . '&pluginversion=' . $this->version;
$this->pluginFile = __FILE__;
$this->pageURL = '?page=' . $this->getRightMost(__FILE__, 'plugins/');
$this->imagePath = WP_PLUGIN_URL . '/' . str_replace(basename( __FILE__), "", plugin_basename(__FILE__)) . '/images/';
$this->externalAdsPath = str_replace(get_site_url(), '', WP_PLUGIN_URL . '/' . str_replace(basename( __FILE__), "", plugin_basename(__FILE__))) . '/ServeAd.php?campaign=';
if(empty($this->pluginDir)) $this->pluginDir = dirname($this->pluginFile);
$this->libraryPath = $this->pluginDir . '/libs/';
$this->handbookPath = $this->pluginDir . '/handbook.txt';
$this->adsense = new AdsenseStats();
$this->db = new SiteDB();
//Language Setup
$locale = get_locale();
$mo = dirname(__FILE__) . "/languages/" . $this->name . "-".$locale.".mo";
load_textdomain($this->name, $mo);
add_action('init', array(&$this, 'InitializePlugin'));
}
public function ActivatePlugin() {
// Ad the rules for exteranl adds back to .htaccess
$inst = AdvertwhirlPlugin::GetInstance();
$inst->FlushRewrites();
}
public function DeactivatePlugin() {
/* Remove the shortcodes */
$this->RemoveShortcodes();
/** Register Admin Style Sheet*/
wp_deregister_style('advertwhirl-plugin-admin-css');
/** Register Admin Javascript*/
wp_deregister_script('advertwhirl-plugin-admin-scripts');
// If external ads are set flush the rules to remove the external ad rules
$this->deactivating = true;
$this->FlushRewrites();
}
// Protected cloner for singleton
private function __clone(){}
public function InitializePlugin(){
if(!$this->initialized){
/* Get plugin data */
global $wp_version;
$this->options = maybe_unserialize(get_option($this->name . "_options"));
/* Hook the actions */
$this->HookActions();
/* Add the shortcodes */
$this->AddShortcodes();
if(gettype($this->options)!="array"){
$this->options = array();
}
if(!isset($this->options['settings']))
$this->options['settings'] = $this->DefaultSettings();
$this->adsense->SetUsername($this->options['settings']['adsense']['username']);
$this->adsense->SetPassword($this->options['settings']['adsense']['password']);
$this->initialized = true;
}
}
private function DefaultSettings(){
$settings = array();
$settings['externalAdsEnabled'] = false;
$settings['adUrlPrefix'] = 'advertwhirl';
/* Default Settings for Adsense */
$adsenseSettings = array();
$adsenseSettings['username'] = "";
$adsenseSettings['password'] = "";
$adsenseSettings['ads-cache'] = 8640;
$adsenseSettings['stats-cache'] = 8640;
$settings['adsense'] = $adsenseSettings;
$analyticsSettings = array();
$analyticsSettings['enabled'] = false;
$analyticsSettings['username'] = "";
$analyticsSettings['password'] = "";
$analyticsSettings['VariablesEnabled'] = true;
$settings['analytics'] = $analyticsSettings;
return $settings;
}
public function HookActions() {
add_action('admin_menu', array(&$this, 'DisplayAdminMenu')); /* Add the admin menu */
add_action('wp_dashboard_setup', array(&$this, 'AddDashboardWidgets')); /* Add the stats widget to the dashboard */
if(!isset($this->rewriteHooked) || !$this->rewriteHooked){
add_action('generate_rewrite_rules', array(&$this, 'RewriteExternalAds'));
$this->rewriteHooked = true;
}
add_action('admin_init', array(&$this, 'AdminInit'));
}
public function AddShortcodes(){
add_shortcode('advertwhirl', array(&$this, 'HandleShortcode_advertwhirl'));
}
public function RemoveShortcodes(){
remove_shortcode('advertwhirl', array(&$this, 'HandleShortcode_advertwhirl'));
}
public function AdminInit(){
foreach(get_option('active_plugins') as $index => $plugin){
if($plugin == 'virtual-theme/VirtualTheme.php'){
$this->virtualThemeInstalled = true;
$this->RuleTypes = array_merge($this->RuleTypes, $this->VirtualThemeRules);
break;
}
}
}
public function FlushRewrites(){
global $wp_rewrite;
if(!isset($this->rewriteHooked) || !$this->rewriteHooked){
add_action('generate_rewrite_rules', array(&$this, 'RewriteExternalAds'));
$this->rewriteHooked = true;
}
$wp_rewrite->flush_rules();
}
public function RewriteExternalAds() {
global $wp_rewrite;
$options = maybe_unserialize(get_option("Advertwhirl_options"));
$prefix = $options['settings']['adUrlPrefix'];
$externalAdsPath = str_replace(get_site_url(), '', WP_PLUGIN_URL . '/' . str_replace(basename( __FILE__), "", plugin_basename(__FILE__))) . '/ServeAd.php?campaign=';
//RewriteRule ^ads/(.*) /wordpress/wp-content/plugins/advertwhirl//ServeAd.php?campaign=$1 [QSA,L]
//RewriteRule ^(vpath)/ads/(.*) /wordpress/wp-content/plugins/advertwhirl//ServeAd.php?campaign=$2&virtualpath=$1 [QSA,L]
if($options['settings']['externalAdsEnabled'] && !$this->deactivating){
$newRules = array(
$prefix . '/(.*)' => $externalAdsPath . '$1'
);
// If Virtual Theme is installed add a rule for each vpath
foreach(get_option('active_plugins') as $index => $plugin){
if($plugin == 'virtual-theme/VirtualTheme.php'){
require_once(WP_PLUGIN_DIR . "/" . $plugin);
$paths = VirtualTheme::GetVirtualPaths();
foreach($paths as $path){
if(strpos($path, '/') === 0)
$path = substr($path, 1);
$newRules['(' . $path . ')/' . $prefix . '/(.*)'] = $externalAdsPath . '$2&virtualpath=/$1';
}
}
}
$wp_rewrite->non_wp_rules = $newRules + $wp_rewrite->non_wp_rules;
}
}
// Get the sole instance of the singleton
static public function GetInstance(){
if(self::$instance === null){
self::$instance = new AdvertwhirlPlugin();
}
return self::$instance;
}
private function GetTechnicalSpecs(){
global $wp_version;
$specs .= "Plugin Specs\n";
$specs = "========================================\n";
$specs .= "Plugin: $this->name\n";
$specs .= "Plugin Version: $this->version\n";
$specs .= "Plugin Directory: $this->pluginDir\n\n";
$specs .= "Server Specs\n";
$specs = "========================================\n";
$specs .= "Server Address: " . $_SERVER['SERVER_ADDR'] . "\n";
$specs .= "Server Name: " . $_SERVER['SERVER_NAME'] . "\n";
$specs .= "Server Software: " . $_SERVER['SERVER_SOFTWARE'] . "\n\n";
$specs .= "Wordpress Specs\n";
$specs = "========================================\n";
$specs .= "Blog Name: " . get_option('blogname') . "\n";
$specs .= "Wordpress Version: $wp_version\n";
$specs .= "Wordpress Siteurl: " . get_option("siteurl") . "\n";
$specs .= "Wordpress Home: " . get_option("home") . "\n";
$specs .= "\tActive Plugins\n";
$specs .= "\t========================================\n";
foreach(get_option('active_plugins') as $index => $plugin){
if(strlen($plugin)>0)
$specs .= "\t$plugin\n";
}
/** PHP Info - @TODO: outputs html and needs to be parsed */
//ob_start();
//phpinfo(INFO_GENERAL or INFO_CONFIGURATION or INFO_MODULES);
//$specs .= ob_get_contents();
//ob_get_clean();
return $specs;
}
function HandleShortcode_advertwhirl($atts, $content = null) {
extract(shortcode_atts(array('campaign' => null), $atts));
$output = 'No Campaign selected';
if(isset($campaign)){
$output = 'advertisement for campaign ' . $campaign;
}
return $output;
}
// Add the stats widget to the dashboard
public function AddDashboardWidgets() {
// Add statistics widget to dashboard
if(isset($this->options['settings']['displayDashboard']) && $this->options['settings']['displayDashboard'])
wp_add_dashboard_widget("AdvertwhirlStatsWidget", "Advertwhirl", array(&$this, "DisplayAdvertwhirlStatsWidget"));
}
public function DisplayAdsenseStats(){
$periods = array();
foreach($this->adsense->GetReportPeriods() as $key => $value){
if(isset($this->options['settings']['adsense']['period'][$key])){
$periods[$key] = $this->options['settings']['adsense']['period'][$key];
}else{
$periods[$key] = false;
}
}
$types = array();
foreach($this->adsense->GetReportTypes() as $key => $value){
if(isset($this->options['settings']['adsense']['type'][$key])){
$types[$key] = $this->options['settings']['adsense']['type'][$key];
}else{
$types[$key] = false;
}
}
$categories = array();
foreach($this->adsense->GetAdCategories() as $key => $value){
if(isset($this->options['settings']['adsense']['category'][$key])){
$categories[$key] = $this->options['settings']['adsense']['category'][$key];
}else{
$categories[$key] = false;
}
}
$this->adsense->LoadStats();
$this->adsense->GetStatTables($periods, $types, $categories);
}
public function DisplayAdvertwhirlStatsWidget(){
echo '| Ad Source | Weight | ' . $_POST['aladweighterror-' . $i . '-' . $index] . ''; if(isset($ad['percent-weight'])){ $content .= ' '; } $content .= ' | '; if($displayRemove){ $content .= ''; } $content .= ' |
|---|
| Name | Description | Action |
|---|---|---|
| ' . $title . ' |
|---|
| Name | Description | Action |
|---|---|---|
| Adsense Login | |||||
|---|---|---|---|---|---|
| Username | Password | ||||
| Caching | |||||
|
How long should Advertwhirl save data it loads from Adsense. Loading data such as reports and ad lists can be slow, turning on caching will make the Advertwhirl control panels more responsive but new settings made at the Adsense website will not be seen immediatly by Advertwhirl. Ad code from is always cached to insure ads are served as quickly as possible. If you make a change to an Adsense Ad Slot that you are using as an ad source you will need to manually update the adsense cache.
|
|||||
| Ad Caching | |||||
| Reports Caching | |||||
| Adsense Reports | |||||
| Get reports for | '; foreach($this->adsense->GetReportPeriods() as $key => $value){ $checked = $this->options['settings']['adsense']['period'][$key]?'checked':''; $content .= ' '; } $content .= ' | ||||
| Statistics to report | '; foreach($this->adsense->GetReportTypes() as $key => $value){ $checked = $this->options['settings']['adsense']['type'][$key]?'checked':''; $content .= ' '; } $content .= ' | ||||
| Get statistics for ad categories | '; foreach($this->adsense->GetAdCategories() as $key => $value){ $checked = $this->options['settings']['adsense']['category'][$key]?'checked':''; $content .= ' '; } $content .= ' | ||||
| Ad Sources | |||
|---|---|---|---|
| Empty Sources | |||
| External Ads | |||
|
Ad campaigns can be accessed from external sites with a permalink style url if external ads are enabled. As these ads are being loaded outside of your wordpress site any of the rules which rely on wordpress variables, posts, pages etc... will be marked false. Even if the external site is also running wordpress, all wordpress rules will be marked false.
|
|||
| Enable External Ads | External URL | ' . get_site_url() . '//your_campaign/ | |
|
If Google Analytics is enabled extra path information after the name of an ad campaign can be added to your analytics code as custom variables.
|
|||
| Add Google Anayltic Variables | |||
|
To use location rules you need a free api key from the IP Info Database. You can request your key here it is a simple form and they will email the key in a few minutes time.
|
|||
| IP Info Database Key | |||
| Dashboard | |||
Mobile Sentience LLC actively supports Advertwhirl if you have any questions or problems you can fill out the form below. The message is pre-filled with some technical specs which will help us troubleshoot any issues. Mobile Sentience provides all support through a public forum, this helps us manage our support costs as well as providing a searchable reference of past problems and questions that other users of encountered. A great place to start if you have a simple question is to see if it has already been asked and answered on the Advertwhirl Support Forum
| Report a problem |
|---|