summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
-rw-r--r--lib/uapplugin.php199
1 files changed, 105 insertions, 94 deletions
diff --git a/lib/uapplugin.php b/lib/uapplugin.php
index f3b16548d..5160d9662 100644
--- a/lib/uapplugin.php
+++ b/lib/uapplugin.php
@@ -22,6 +22,7 @@
* @category Action
* @package StatusNet
* @author Sarven Capadisli <csarven@status.net>
+ * @author Evan Prodromou <evan@status.net>
* @copyright 2010 StatusNet, Inc.
* @license http://www.fsf.org/licensing/licenses/agpl-3.0.html GNU Affero General Public License version 3.0
* @link http://status.net/
@@ -32,145 +33,155 @@ if (!defined('STATUSNET') && !defined('LACONICA')) {
}
/**
+ * Abstract superclass for advertising plugins
+ *
+ * Plugins for showing ads should derive from this plugin.
+ *
* Outputs the following ad types (based on UAP):
+ *
* Medium Rectangle 300x250
* Rectangle 180x150
* Leaderboard 728x90
* Wide Skyscraper 160x600
*
- * Any number of ad types can be used. Enable all using example:
- * addPlugin('UAP', array(
- * 'MediumRectangle' => '<script type="text/javascript">var foo = 1;</script>',
- * 'Rectangle' => '<script type="text/javascript">var bar = 2;</script>',
- * 'Leaderboard' => '<script type="text/javascript">var baz = 2;</script>',
- * 'WideSkyscraper' => '<script type="text/javascript">var bbq = 4;</script>'
- * )
- * );
- *
* @category Plugin
* @package StatusNet
* @author Sarven Capadisli <csarven@status.net>
+ * @author Evan Prodromou <evan@status.net>
* @license http://www.fsf.org/licensing/licenses/agpl-3.0.html GNU Affero General Public License version 3.0
* @link http://status.net/
*/
-class UAPPlugin extends Plugin
+abstract class UAPPlugin extends Plugin
{
public $MediumRectangle = null;
- public $Rectangle = null;
- public $Leaderboard = null;
- public $WideSkyscraper = null;
-
- function __construct($uap = array())
- {
- $this->uap = $uap;
-
- parent::__construct();
- }
-
- function onInitializePlugin()
- {
- foreach($this->uap as $key => $value) {
- switch(strtolower($key)) {
- case 'mediumrectangle': default:
- $this->MediumRectangle = $value;
- break;
- case 'rectangle':
- $this->Rectangle = $value;
- break;
- case 'leaderboard':
- $this->Leaderboard = $value;
- break;
- case 'wideskyscraper':
- $this->WideSkyscraper = $value;
- break;
- }
- }
- }
+ public $Rectangle = null;
+ public $Leaderboard = null;
+ public $WideSkyscraper = null;
+
+ /**
+ * Output our dedicated stylesheet
+ *
+ * @param Action $action Action being shown
+ *
+ * @return boolean hook flag
+ */
function onEndShowStatusNetStyles($action)
{
- $action->cssLink(common_path('plugins/UAP/uap.css'),
- null, 'screen, projection, tv');
+ // XXX: allow override by theme
+ $action->cssLink('css/uap.css', 'base', 'screen, projection, tv');
return true;
}
- //MediumRectangle ad
+ /**
+ * Add a medium rectangle ad at the beginning of sidebar
+ *
+ * @param Action $action Action being shown
+ *
+ * @return boolean hook flag
+ */
+
function onStartShowAside($action)
{
- if (!$this->MediumRectangle) {
- return true;
- }
+ if (!is_null($this->mediumRectangle)) {
- $this->showAd($action, array('id' => 'ad_medium-rectangle'),
- $this->MediumRectangle);
+ $action->elementStart('div',
+ array('class' => 'ad_medium-rectangle ad'));
- return true;
- }
+ $this->showMediumRectangle($action);
-/*
- //Rectangle ad
- function onEndShowSiteNotice($action)
- {
- if (!$this->Rectangle) {
- return true;
+ $action->elementEnd('div');
}
- $this->showAd($action, array('id' => 'ad_rectangle'),
- $this->Rectangle);
-
return true;
}
-*/
- //Leaderboard and Rectangle ad
+ /**
+ * Add a leaderboard and/or rectangle in the header
+ *
+ * @param Action $action Action being shown
+ *
+ * @return boolean hook flag
+ */
+
function onStartShowHeader($action)
{
- if ($this->Leaderboard) {
- $this->showAd($action, array('id' => 'ad_leaderboard'),
- $this->Leaderboard);
+ if (!is_null($this->leaderboard)) {
+ $action->elementStart('div',
+ array('class' => 'ad_leaderboard ad'));
+ $this->showLeaderboard($action);
+ $action->elementEnd('div');
}
- if ($this->Rectangle) {
- $this->showAd($action, array('id' => 'ad_rectangle'),
- $this->Rectangle);
+ if (!is_null($this->rectangle)) {
+ $action->elementStart('div',
+ array('class' => 'ad_rectangle ad'));
+ $this->showRectangle($action);
+ $action->elementEnd('div');
}
return true;
}
- //WideSkyscraper ad
+ /**
+ * Add a wide skyscraper after the aside
+ *
+ * @param Action $action Action being shown
+ *
+ * @return boolean hook flag
+ */
+
function onEndShowAside($action)
{
- if (!$this->WideSkyscraper) {
- return true;
- }
+ if (!is_null($this->wideSkyscraper)) {
+ $action->elementStart('div',
+ array('class' => 'ad_wide-skyscraper ad'));
- $this->showAd($action, array('id' => 'ad_wide-skyscraper'),
- $this->WideSkyscraper);
+ $this->showWideSkyscraper($action);
+ $action->elementEnd('div');
+ }
return true;
}
- //Output ad container
- function showAd($action, $attr=array(), $value)
- {
- $classes = ($attr['class']) ? $attr['class'].' ' : '';
-
- $action->elementStart('div', array('id' => $attr['id'],
- 'class' => $classes.'ad'));
- $action->raw($value);
- $action->elementEnd('div');
- }
-
- function onPluginVersion(&$versions)
- {
- $versions[] = array('name' => 'UAP',
- 'version' => STATUSNET_VERSION,
- 'author' => 'Sarven Capadisli',
- 'homepage' => 'http://status.net/wiki/Plugin:UAP',
- 'rawdescription' =>
- _m('Outputs ad placements based on Universal Ad Package'));
- return true;
- }
+ /**
+ * Show a medium rectangle ad
+ *
+ * @param Action $action Action being shown
+ *
+ * @return void
+ */
+
+ abstract protected function showMediumRectangle($action);
+
+ /**
+ * Show a rectangle ad
+ *
+ * @param Action $action Action being shown
+ *
+ * @return void
+ */
+
+ abstract protected function showRectangle($action);
+
+ /**
+ * Show a wide skyscraper ad
+ *
+ * @param Action $action Action being shown
+ *
+ * @return void
+ */
+
+ abstract protected function showWideSkyscraper($action);
+
+ /**
+ * Show a leaderboard ad
+ *
+ * @param Action $action Action being shown
+ *
+ * @return void
+ */
+
+ abstract protected function showLeaderboard($action);
}