Banner-Modul revisited

[herr rilke]

hallo!

ich brauchte ein banner-modul für WB, dass ich auch hier fand:
http://www.websitebakers.com/pages/modules/listings/various/banner.php?searchresult=1&sstring=banner,

"rolf" hat einen klasse job gemacht für die idee und zuordnung - hut ab, da wäre ich erst mal nicht drauf gekommen und die zuordnung ist ziemlich gut gelöst!

doch es gab probleme mit der verlässlichkeit, da manchmal banner verschwanden (keine ahnung, wieso), der kunde das nicht so gut fand und tja, ein wenig anderes wollte & vor allem es einfacher wollte.

daher möchte ich euch das ergebnis zur verfügung stellen.

key features (veränderungen zu rolfs vers. 0.1)

• zeitgesteuerte veröffentlichung (folgt der zeitsteuerung der abschnitte, in denen die banners definiert werden)
• anzeige der anzahl von einblendungen
• unterstützung von WYSIWYG und Code2 abschnitten (installiertes Code2 voraussetzung!)
• banners werden inhaltlich in der übersicht angezeigt (sonst versteht's ja keiner :)
• automatische zuordnung neuer und aktualisierung gelöschter banners (keine zusätzlichen nutzer-aktionen erforderlich - außer aufruf des tools via [Admin-Tools] > [Banner Admin])
• Banner werden jetzt automatisch sortiert nach
     a) page
     b) section_id

voraussetzungen:

•     * WebsiteBaker 2.7+
•     * PHP 5.2 oder höher
•     * installiertes modul CODE2 wirklich!
•     * banner UND banneradmin müssen installiert werden! wirklich

installation und inbetriebnahme siehe unten

es ist noch nicht alles gold (s. u.) und wer verbessern möchte, mag gern code beisteuern.
einfach wäre z.B. die anzahl von clicks zu tracken usw.
aber das mag man sich auch selbst schreiben  :-D

hier noch das README und das change.log und dann bin ich für heute raus :)

viele grüße aus münster !



README
banneradmin, version 0.3
=======================
A admin modul for the WebsiteBaker CMS software. It provides the ability to
maintain the banners displayed by the according snippet banner.


QUICK INSTALL
=============
1. Install banner.zip and banneradm.zip
2. Define $block[20] = Banner
   (Banner is defined in Language File)
3. Add Banner block to any page
4. Add <?php show_banner() ?> to template
5. Configure pages for template:
   - Backend Advanced Settings -> Banner Admin
   - set pages were banner shall be shown

INSTALLATION
============
1. Download the latest version
2. Log into your WebsiteBaker installation
3. Go to Addons -> Modules
4. If a previous version of banneradm and banner is already installed, select it from
   the "Uninstall Module" list and choose the "Uninstall" button.
5. In the "Install Module" section, enter the path to the banneradm.zip and banner.zip file
   that you downloaded in step 1, and choose the "Install" button for both modules.

USING BANNERS
=============
First you need to enable blocks in the WebsiteBaker backend. After that specify
the block used for banners by adding a statement like
$block[20] = Banner
to info.php of your currently used template.
Asure that you do not use page_content(20) in your template.

If you plan to have more banner sections in your template add
   define('NUM_BANNER', '5');
to config.php of you WebsiteBaker installation.
(defaults to 3).


Now you are able to create a banner and use it.

CREATING A BANNER
=================
Simply get to any page and add a new banner block as WYSIWYG or Code2 (requires you installed that plugin) block.
For displaying the content I currently do not provide any restrictions, so pay
attention on the size of the banner.
Currently WYSIWYG and Code2 blocks are supported.

PREPARE THE TEMPLATE
====================
In your template add a section like
/**
 * WERBUNG
 *
 */
$_banner = NULL;

ob_start();
show_banner(1);
$foo=ob_get_contents();
ob_end_clean();
if ($foo <> "") {
   $_banner= '<div class="werbe_banner">' . $foo .'</div>';
  }

ob_start();
show_banner(2);
$foo=ob_get_contents();
ob_end_clean();
if ($foo <> "") {
   $_banner.= '<div class="werbe_banner">' . $foo .'</div>';
}

/***********/
to display the banner.

MAINTAIN BANNER PAGE RELATIONS
==============================
Now you can decide on which page the banner should be shown.
Go to "Admin-Tools" in the settings section of the backend and hit Banner Admin.

You can enable the banner on the now displayed page.
The banners start from the left hand side with 1 upto NUM_BANNER.

To know wich ID/number belongs to wich banner click on "banner overview" at pages bottom.
Maybe you feel like printing it for easy use.



UNINSTALLING BANNERS
====================
Simply execute step 4 of the installation for both moduls.

I would be glad about any questions, suggestions or comments.

Have fun.

Rolf (version 0.1)
herr rilke (version 0.2 & 0.3)






change.log:
/**
* herr rilke on
* mod version 0.2 -> 0.3
* Juni 2010
*/

--> überarbeitung der zuordnungen (zählte einige banner nicht, indexe wurden immer neu geschrieben, unübersichtlicher code)
--> sortierung der banner im BannerAdmin entfernt.
   Banner werden jetzt sortiert nach
   a) page
   b) section_id
   wenn also alle banner in einer versteckten Page angelegt werden, kann die Reihenfolge durch die Reihenfolge der
   Abschnitte festgelegt werden. Wenn das denn hilfreich ist.
--> ALTER TABLE `mod_banner`
   CHANGE COLUMN `banner_id` `banner_id` INT(11) UNSIGNED NOT NULL AUTO_INCREMENT FIRST;
--> WYSIWYG und Code2 werden unterstützt (performanter, flexibler in der banner-eingabe, JS-Code mögl. usw.)
--> automatische überprüfung auf änderungen / löschung von bannern, kein manuelles auslösen der aktionen
--> Unmengen Notices entfernt, aber noch nicht alle HTML warnungen





/**
* herr rilke on
* mod version 0.1 -> 0.2
*/

--> datenbank zählt die anzahl der angezeigten banner
--> verlinkung im backend auf "AdminTools" umgestellt (für WB 2.8)
--> banner folgen der zeitsteuerung, wenn die banner in abschnitten mit start- und end-datum untergebracht sind
--> anzeige der banner (mit allen gefahren daraus) auf "preview-modus" geändert zur erhöhung der übersichtlichkeit
--> anzeige der "hits" für jedes banner im BE

[Stefek]

Sehr coole Idee, das noch mal zu überarbeiten, Herr Rilke.

Werde ich mir morgen gleich anschauen und Feedback geben.

Gruß,
Stefek

[PurpleEdge]

Is there an example page, or site, so we can see what it looks like in action?

[crnogorac081]

I am wondering is there some statistics like number of views and clicks on banner ?

[herr rilke]

hi,

sorry for being _that_ late

just give it a try: it counts all views but for the moment no clicks, as it would be needed a link target that is different from the one you could now easily supply in the WYSIWYG editor.

something like banner_counter.php?banner_id=5.
so banner_counter.php should provide some logic to count the clicks for the banner with id = 5.

HTH

herr rilke

[premagraphic]

hello,
I did not understand what to write on the file info.php when I have more sections of the banner.
Could you help me?
thanks

[herr rilke]

hi premagraphic,

as for now some parts are hardcoded, banner module supports just 1 banner-area, where you can display different banners or ads on a per page basis.

best regards

[premagraphic]

What do you mean when you explain this:

If you plan to have more banner sections in your template add
   define('NUM_BANNER', '5');
to config.php of you WebsiteBaker installation.
(defaults to 3).

[herr rilke]

hi,

in banner admin you can match single pages with a selection of banners (ads, what ever).

 define('NUM_BANNER', '5');

gives you the oportunity to select 5 different banners that are displayed in your page. defining nothing defaults 'NUM_BANNER' to 3, meaning you can select 3 different ads.

but still: all these 3 (or 5 or...) ads are shown in one section of your page.

brgd

[premagraphic]

I understand
Thank you for your time, I hope that in future you can make these improvements to this module very nice

[instantflorian]

Hallo,

ich habe beide Module installiert, das Template wie beschrieben ergänzt und 2 Testbanner, einmal als wysiwyg und einmal als code2, angelegt. Im BannerADmin werden auch fleißig Einblenungen gezählt, nur sieht man, dass man nichts sieht, will sagen, im Frontend erscheinen die Banner nicht. Auch der Testtext "nix" und "wieder nix" erscheint nicht.

Gibt es noch irgend etwas anderes, was zu beachten ist?

WB 2.8.1 Rev. 1287

Hier der Code aus dem Template (All CSS):

Code:

-----8<-------schnipp

<div class="content">
<?php
/**
 * WERBUNG
 *
 */
$_banner = NULL;

ob_start();
show_banner(1);
$foo=ob_get_contents();
ob_end_clean();
if ($foo <> "") {
   $_banner= '<div class="werbe_banner">' . $foo .'</div>';
  } else {
    $_banner='nix';
  }

ob_start();
show_banner(2);
$foo=ob_get_contents();
ob_end_clean();
if ($foo <> "") {
   $_banner.= '<div class="werbe_banner">' . $foo .'</div>';
}  else {
    $_banner='wieder nix';
  }

/***********/
?>

<?php page_content(); ?>

----->8-------schnipp

Danke im voraus, Grüße
-instantflorian.

[Olli]

hi leute,

ich habe die page_id in der info.php hinzugefügt, in der ich einen banner als WYSIWYG hinterlegt habe.
außerdem habe ich die max. anzahl an bannern in der config.php gesetzt.

trotzdem erscheint im adminbereich unter "banner admin" in der auswahlliste immer nur "leer", d.h. die zugeordneten banner werden wohl nicht erkannt oder eingelesen...

hat jemand von euch eine idee?

beste grüße,
olli

[marmot]

Hi,

hat jemand von euch eine idee?

ich habe mal eine Version 0.4 gebastelt und unter wb283 getestet. Vielleicht kannst du damit was anfangen. Bitte das Readme lesen.

Gruß

[garibaldi]

Hi,

hat jemand von euch eine idee?

ich habe mal eine Version 0.4 gebastelt und unter wb283 getestet. Vielleicht kannst du damit was anfangen. Bitte das Readme lesen.

Gruß

Na da stimmt irgendwas nicht, habe nachdem die version 03 genau wie bei olli nicht funktionierte die version 04 von dir installiert, jetz taucht das banneradminmodul nicht im adminbereich auf, lässt sich aber auch nicht mehr deinstallieren, da es auch unter den erweiterungen nicht auftaucht. Eine erneute installation schlägt aber auch fehl, da wird dann gemeldet, das das modul schon installiert sei.

Any ideas ?

[garibaldi]

Habs jetzt hinbekommen das Adminodul zu löschen, habe es per FTP aus dem Ordner /modules gelöscht und die Version 03 wieder installiert.
Ich bekomme es aber immer noch nicht hin, das ein Banner gezeigt wird und im Adminbereich steht auch alles auf leer.
Wenn ich jetzt in die Bannerübersicht wechsele bekomme ich folgende Fehlermeldung:

Call to a member function numRows() on a non-object in /var/www/web2/html/cms/modules/banneradm/tool_mod_banner.php on line 77

Ich benutze WB 2.8.3 Rev. 1611.

Schade, wenn das Modul nicht funktioniert  .

Grüße Holger

[dbs]

wenn ich marmot richtig verstehe, brauchst du nicht banner03 + banneradm04, sondern nur banneradm04.
dieser legt das seitenmodul banner mit an.

sollte man vorher banner03 installiert haben, dann gibts ein problem, wenn man banneradm04 installiert. seite wird abgebrochen und modul erschient nicht in den admin-tools. in dem fall module neuladen lassen (erweiterungen > erweitert)

[marmot]

Hi,
Habs jetzt hinbekommen das Adminodul zu löschen, habe es per FTP aus dem Ordner /modules gelöscht und die Version 03 wieder installiert.
Ich bekomme es aber immer noch nicht hin, das ein Banner gezeigt wird und im Adminbereich steht auch alles auf leer.

also es ist ja nun schon 2 Monate her und ich weiß nicht mehr was genau ich geändert habe, aber da ich version 0.4 daraus gemacht hatte, schätze ich es war schon etwas mehr. Ich würde deshalb doch raten, die letzte Version zu verwenden, nachdem du version 0.3 möglichst sauber deinstalliert hast. (und zwar banner und banneradmin).
Dann nehme ich an, du hast die readme doch nicht so ganz genau befolgt  .
-Hast du die Einträge in info.php und index.php des (richtigen) Templates gemacht?
-Hast du der Section mit dem Banner den Block 20 zugewiesen?

Wenn ich jetzt in die Bannerübersicht wechsele bekomme ich folgende Fehlermeldung:
Call to a member function numRows() on a non-object in /var/www/web2/html/cms/modules/banneradm/tool_mod_banner.php on line 77

Das liegt daran, dass du das Modul Code2 nicht installiert hast. Steht allerdings wirklich nicht so direkt in der readme . Aber das Modul funktioniert auch ohne die Übersicht.

Schade, wenn das Modul nicht funktioniert  .

Sehe ich genauso, insbesondere wenn ich meine Finger im Spiel hatte  und deshalb habe ich es noch mal für dich getestet:
Neues wb283 (1638), die module banneradmin und code2 installiert, richtiges Template an den richtigen Stellen editiert und Banner mit dem richtigen Block angelegt.
=> alles funktioniert wunderbar 

Gruß

[dbs]

=> alles funktioniert wunderbar  smiley

kann ich bestätigen (Rev. 1677)