3 * StatusNet, the distributed open-source microblogging tool
5 * UAP (Universal Ad Package) plugin
9 * LICENCE: This program is free software: you can redistribute it and/or modify
10 * it under the terms of the GNU Affero General Public License as published by
11 * the Free Software Foundation, either version 3 of the License, or
12 * (at your option) any later version.
14 * This program is distributed in the hope that it will be useful,
15 * but WITHOUT ANY WARRANTY; without even the implied warranty of
16 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
17 * GNU Affero General Public License for more details.
19 * You should have received a copy of the GNU Affero General Public License
20 * along with this program. If not, see <http://www.gnu.org/licenses/>.
24 * @author Sarven Capadisli <csarven@status.net>
25 * @author Evan Prodromou <evan@status.net>
26 * @copyright 2010 StatusNet, Inc.
27 * @license http://www.fsf.org/licensing/licenses/agpl-3.0.html GNU Affero General Public License version 3.0
28 * @link http://status.net/
31 if (!defined('STATUSNET') && !defined('LACONICA')) {
36 * Abstract superclass for advertising plugins
38 * Plugins for showing ads should derive from this plugin.
40 * Outputs the following ad types (based on UAP):
42 * Medium Rectangle 300x250
45 * Wide Skyscraper 160x600
49 * @author Sarven Capadisli <csarven@status.net>
50 * @author Evan Prodromou <evan@status.net>
51 * @license http://www.fsf.org/licensing/licenses/agpl-3.0.html GNU Affero General Public License version 3.0
52 * @link http://status.net/
55 abstract class UAPPlugin extends Plugin
57 public $MediumRectangle = null;
58 public $Rectangle = null;
59 public $Leaderboard = null;
60 public $WideSkyscraper = null;
63 * Output our dedicated stylesheet
65 * @param Action $action Action being shown
67 * @return boolean hook flag
70 function onEndShowStatusNetStyles($action)
72 // XXX: allow override by theme
73 $action->cssLink('css/uap.css', 'base', 'screen, projection, tv');
78 * Add a medium rectangle ad at the beginning of sidebar
80 * @param Action $action Action being shown
82 * @return boolean hook flag
85 function onStartShowAside($action)
87 if (!is_null($this->mediumRectangle)) {
89 $action->elementStart('div',
90 array('class' => 'ad_medium-rectangle ad'));
92 $this->showMediumRectangle($action);
94 $action->elementEnd('div');
101 * Add a leaderboard and/or rectangle in the header
103 * @param Action $action Action being shown
105 * @return boolean hook flag
108 function onStartShowHeader($action)
110 if (!is_null($this->leaderboard)) {
111 $action->elementStart('div',
112 array('class' => 'ad_leaderboard ad'));
113 $this->showLeaderboard($action);
114 $action->elementEnd('div');
117 if (!is_null($this->rectangle)) {
118 $action->elementStart('div',
119 array('class' => 'ad_rectangle ad'));
120 $this->showRectangle($action);
121 $action->elementEnd('div');
128 * Add a wide skyscraper after the aside
130 * @param Action $action Action being shown
132 * @return boolean hook flag
135 function onEndShowAside($action)
137 if (!is_null($this->wideSkyscraper)) {
138 $action->elementStart('div',
139 array('class' => 'ad_wide-skyscraper ad'));
141 $this->showWideSkyscraper($action);
143 $action->elementEnd('div');
149 * Show a medium rectangle ad
151 * @param Action $action Action being shown
156 abstract protected function showMediumRectangle($action);
159 * Show a rectangle ad
161 * @param Action $action Action being shown
166 abstract protected function showRectangle($action);
169 * Show a wide skyscraper ad
171 * @param Action $action Action being shown
176 abstract protected function showWideSkyscraper($action);
179 * Show a leaderboard ad
181 * @param Action $action Action being shown
186 abstract protected function showLeaderboard($action);