Herzlich Willkommen auf blog.philippfleck.de bei Philipp's Blog

Inhalt / Content

Deutsch

• Über hideAd
• Download
• Installation
• Anpassungen
• Lizenz
• FAQ

English

• About hideAd
• Download
• Installation
• Customization
• Licence
• FAQ

Über hideAd 

hideAd ist ein Plugin für Wordpress 2.x das dem Besitzer des Blogs die Möglichkeit bietet Werbung zu schalten, aber seinen regelmäßigen Besuchern trotzdem die Möglichkeit bietet die Werbeanzeigen auszublenden. Der Vorteil liegt klar auf der Hand: regelmäßige Besucher bekommen einen werbefreien Blog zu Gesicht, Zufalls- oder Einmalbesucher dagegen bekommen die Werbung angezeigt. Natürlich kann man nicht nur Werbung sodern alles, was man irgendwie in den Templates verbauen kann.

Das Prinzip des Plugins ist eigentlich ganz einfach: Es klinkt sich in die Wordpress-Pluginstruktur ein und setzt, wenn der Stammbesucher keine Werbung wünscht ein Cookie das diese Information enthält.

Dieses Plugin ist auf Anregung von Peter Sawatzki entstanden, der sowas für seinen Blog haben wollte und mich um Unterstützung bat.

Download

Download der aktuellen Version 0.11.

Ich bitte Diejenigen, die das Plugin einsetzen, kurz in den Kommentaren verewigen. Danke

Installation

Die Installation des Plugins ist eigentlich ganz einfach:

1. Datei entpacken und hideAd.php ins verzeichnis wp-content/plugins/ kopieren.
2. In der Administrationsoberfläche  einloggen und unter Plugins das Plugin "hideAd" aktivieren.
3. Um den Link zum deaktivieren der Werbung anzuzeigen im Template an gewünschter Stelle <?php hideAd_link(); ?> einfügen. Der Text ist von Haus aus Englisch. Wie man ihn anpasst wird unter Anpassungen beschrieben
4. Um einen Werbeblock bei bedarf auszublenden muss dieser innerhalb folgendes Konstruktes stehen:
   <?php if(hideAd_status()) { ?>
   hier steht der Code der Werbung
   <?php } // Ende von hideAd ?>

Anpassungen

Anpassung des Link-Textes:

Es lässt sich zum einen der Text selbst anpassen, indem der Funktion hideAd_link() diese Texte als Parameter übergeben werden. Der erste Parameter ist der Text zum ausblenden, der zweite der Text zum einblenden:
hideAd_link("Werbung ausblenden","Werbung einblenden"
erzeugt also eine deutsche Ausgabe der Linktexte.

Die Darstellung des Linkes kann man mittels CSS manipulieren. Die CSS-Klassen dazu lauten
wp-hideAd_hide und wp-hideAd_show.
Mit folgendem CSS-Schnipsel wird zum Beispiel eingestellt, dass der Text bei beiden Links weiß ist, der Hintergrund beim Ausblenden aber grün und beim Einblenden rot:

.wp-hideAd_hide, .wp-hideAd_show {   color: #fff; } .wp-hideAd_hide {   background: #0c0; } .wp-hideAd_show {   background: #c00; } 

Anpassung der Lebensdauer des Cookies

Über die Lebensdauer des Cookies kann man einstellen, nach welcher Zeit der Browser des Besuchers die Einstellung vergisst. Bei jedem Seitenaufruf wird das Cookie erneuert, so dass regelmäßige Besucher selten die Einstellung erneuern müssen.
Die eigentliche Lebensdauer stellt man über die Variable $hideAd_lifetime in der hideAd.php in Zeile 28 ein. Dort muss die Güitsdauer des Cookies in Sekunden angegeben werden. Vorgabe ist 3600*24*7, was sieben Tagen oder eine Woche entspricht.

Lizenz

hideAd steht unter der GNU General Public Licence GPL. Dieses Plugin ist also freie Software und darf unter den Bedingungen der GPL verändert und/oder weiterverbreitet werden.

Der komplette Lizenztext der GPL findet sich hier. Die inoffizielle deutsche Übersetzung hier

Auch wenn es die GPL nicht vorschreibt, so bitte ich trotzdem darum, dass wenn jemand dieses Plugin verbessert oder verändert, mir eine Kopie davon zu senden, damit mögliche Verbesserungen allen zugute kommen.

FAQ

Bisher gibt es noch keine regelmäßigen Fragen. Sollten Fragen auftauchen, die für die Allgemeinheit interessant sein könnten, dann werde ich sie hier hinzufügen. Wer eine Frage hat darf gerne so frei sein, und sie stellen

About hideAd 

hideAd is a Plugin for Wordpress 2.x that allows the owner of the blog to embed advertisement but anyhow give the periodical visitors the posibility to hide these ads. The advantage is obvious: continous visitors uses an ads-free blog, once-visitors and those who came from a search-engine see the advertisements. Needless to say that not only advertisements but everything that can be built into templates can be hidden.

The principle of the plugin is quite simple: It plugges itself into the plugin-structure of Wordpress and sets, if an visitor don't want wo see advertisements, a cookie, that contains this information.

This plugin was developed from a suggestion of Peter Sawatzki. He searched something like this for his blog and asked me for assistance.

Download

Download of the current version 0.11.

I request all that uses this plugin to leave a comment Thanks

Installation

The installation of the plugin is quite easy:

1. unpack the File and copy hideAd.php into following directory wp-content/plugins/.
2. Login into the admininterface of Wordpress select the "Plugins"-button in the main-navigation and activate the plugin "hideAd".
3. To show the link for hiding the advertisements edit your template and add <?php hideAd_link(); ?> at the favored place. The default texts of the links are "hide Ads" and "show Ads". How to modify these texts is described in Customization.
4. To hide an advertisement it has to be placed within following construct:
   <?php if(hideAd_status()) { ?>
   here the code of the advertisement
   <?php } // end of hideAd ?>

Customization

Customization of the link-text:

The link-text can be modified by committing these texts as parameters to the hideAd_link()-function. The first parameter stands for the text that hides the ads, the second is the text to show the ads again. For example: hideAd_link("Ads off!","Ads on!"

The format of the links can be manipulated with CSS. The names of the CSS-Classes are:
wp-hideAd_hide und wp-hideAd_show.
As example, the following CSS-snippet defines the text-color of the links white, the background of the hiding-link green and the backround of the showing-link red:

.wp-hideAd_hide, .wp-hideAd_show {   color: #fff; } .wp-hideAd_hide {   background: #0c0; } .wp-hideAd_show {   background: #c00; } 

Modification of the lifetime of the cookies

With the lifetime of the cookie can be setted up, in witch period the browser of the users forgets the settings. The cookie is renewed with every requested page, so that periodical visitors have to renew their settings seldom.
This lifetime is setted up with the variable $hideAd_lifetime in hideAd.php in line 28. The duration of validity has to be set up in seconds. The presetting is 3600*24*7, what means seven days or one week .

Licence

hideAd is published under the GNU General Public Licence GPL. This means, that this plugin is free software and can be modified and/or redistributed under the terms of GPL.

The complete text of the licence can be found here.

As well as GPL does it not instructs, I appeal nevertheless that if someone improves or modifies this plugin to send me a copy of it, on order that possible improvements benefits to all.

FAQ

There are no FAQs so far. If you have a question or a Problem with this plugin feel free and ask