Jump to content

Extension:WimaWerbung

From mediawiki.org
This page is a translated version of the page Extension:WimaAdvertising and the translation is 95% complete.
MediaWiki-Erweiterungen
WimaAdvertising
Freigabestatus: stabil
Einbindung BenutzeroberflÀche , MeinWiki , Hook
Beschreibung Werbebanner in LocalSettings.php definiert
Autor(en) WikiMANNia (WikiForMenDiskussion)
Letzte Version 2.8.5 (2024-09-20)
MediaWiki 1.35+
PHP 7.3.19+
Lizenz GNU General Public License 2.0 oder neuer
Herunterladen
Beispiel http://42.wikimannia.org
  • $wgWimaAdvertising
  • $wgWimaAdvertisingAnonOnly
  • $wgBannerTopCode
  • $wgBannerTopStyle
  • $wgBannerTopType
  • $wgBannerBottomCode
  • $wgBannerBottomStyle
  • $wgBannerBottomType
  • $wgSidebarAd1Code
  • $wgSidebarAd1Type
  • $wgSidebarAd2Code
  • $wgSidebarAd2Type
  • $wgGoogleAdSense
  • $wgGoogleAdSenseAnonOnly
  • $wgGoogleAdSenseClient
  • $wgGoogleAdSenseHost
  • $wgGoogleAdSenseMode

Die WimaAdvertising-Erweiterung bietet vier zusĂ€tzliche Werbe -Blöcke zu den Cologne Blue , Modern , Monaco , MonoBook , Timeless , Vector -OberflĂ€chen. Die Banner werden oben und unten im Wiki platziert und zwei davon in der Navigationsleiste . Google Adsense wird unterstĂŒtzt.

Verwendung

Ein Anzeigenblock befindet sich oben im "MediaWiki:Sitenotice", ein zweiter unterhalb des Artikeltextes und ĂŒber der Kategorieleiste und zwei weitere Anzeigenblöcke in der "Navigationsleiste ". Durch das Eintragen von * AD1 und * AD2 in der MediaWiki:Sidebar können diese individuell platziert werden. Wenn Seitennotiz definiert ist, wird das TopBanner zufĂ€llig im Wechsel mit der Seitennotiz angezeigt.

Installation

For recent versions of MediaWiki (1.35+), use the following instruction:

Installation for older versions of MediaWiki

For MediaWiki 1.23-1.34, replace the above-mentioned "git clone" command with the following: git clone -b REL1_25 https://github.com/WikiMANNia/MediaWiki-Extension-WimaAdvertising.git

Allgemeine Konfiguration

Werbebanner aktivieren. Vorgabewert ist false.

$wgWimaAdvertising = true;

Werbebanner fĂŒr eingeloggte Benutzer deaktivieren. Vorgabewert ist false.

$wgWimaAdvertisingAnonOnly = true;

Wima-Werbeblöcke

BannerType

Setze den Typ des Eintrags.

  • Mögliche Werte sind: 'advertising', 'blank', 'eventnote', 'hint'
  • Vorgabewert: 'advertising'

Ist dieser Wert auf blank gesetzt, wird das Portlet nicht beschriftet.

$wgBannerTopType = "advertising";
$wgBannerBottomType = "blank";
$wgSidebarAd1Type = "eventnote";
$wgSidebarAd2Type = "hint";
Die Beschriftungen ĂŒber den Werbeblöcken werden ĂŒbersetzt in: de, en, es, fr, it, nl, pt, ru

BannerCode

Ein HTML-Snippet des Werbeeintrags setzen.

$wgBannerTopCode = '<a title="Uhren-Wiki" href="https://www.uhren-wiki.net"><img src="https://wikimannia.org/skins/werbung/Werbung - Oben.jpg" width="728" height="92" alt="Werbung" /></a>';
$wgBannerBottomCode = '
Your banner code here.
';
$wgSidebarAd1Code = '<a title="Schwarzbuch Wikipedia" href="https://de.wikimannia.org/Schwarzbuch_Wikipedia"><img src="https://wikimannia.org/werbung/images/130px-Schwarzbuch_Wikipedia.jpg" alt="Schwarzbuch_Wikipedia.jpg" /></a> <p><b>Schwarzbuch Wikipedia</b></p><p class="small">Mobbing, Diffamierung und Falschinformation in der Online-EnzyklopÀdie, und was jetzt dagegen getan werden muss.</p><p>Im Februar 2020 im <i>Zeitgeist-Verlag</i> erschienen.</p>';
$wgSidebarAd2Code = 'Your banner code here.';

Auch Google AdSense kann gemacht werden:

$wgSidebarAd2Code = '<script type="text/javascript"><!--
google_ad_client = "9471398824076666"; // "pub-9471398824076666"
/* ID 007 */
google_ad_slot = "3512091103";
google_ad_width = 145;
google_ad_height = 260;
google_language = "en";
google_encoding = "utf8";
// -->
</script>
<script type="text/javascript" src="http://pagead2.googlesyndication.com/pagead/show_ads.js">
</script>';

BannerStyle

Die CSS-Stilvorgaben fĂŒr das Banner festlegen.

$wgBannerTopStyle = 'text-align:center;border:1px solid blue;';
$wgBannerBottomStyle = 'text-align:center;border:1px dotted red;';
$wgSidebarAd1Style = '';
$wgSidebarAd2Style = '';

Google Adsense

Werbebanner aktivieren. Vorgabewert ist false.

$wgGoogleAdSense = true;

Werbebanner fĂŒr eingeloggte Benutzer deaktivieren. Vorgabewert ist false.

$wgGoogleAdSenseAnonOnly = true;

Der Typ des Eintrags ist hier auf 'advertising' festgelegt.

Pflicht-Parameter

// Replace this with your own publisher ID (google_ad_client / data-ad-client)
$wgGoogleAdSenseClient = 'none'; // Client ID for your AdSense script
$wgGoogleAdSenseHost = 'none'; // Host ID for your AdSense script

(You can get your publisher ID and ad unit ID from the "Get code" page: Get and copy the ad code.)

Optionale Parameter

Folgende optionale Einstellungen können hinzugefĂŒgt werden, wenn sie von den Vorgabewerten abweichen:

// Source URL of the AdSense script. No need to change - it can't deviate from the defaults.
$wgGoogleAdSenseSrc = '//pagead2.googlesyndication.com/pagead/js/adsbygoogle.js';
$wgGoogleAdSenseSrc = '//pagead2.googlesyndication.com/pagead/js/adsbygoogle.js?client=ca-pub-1234&host=ca-host-pub-5678';

// AdSenseMode. Default is 'normal'.
$wgGoogleAdSenseMode = 'responsive'; (since 2.8.2)

// Text coding. Default is 'utf8'.
$wgGoogleAdSenseEncoding = "utf8"; (until 2.7.1)

// Advertising language. Default is $wgLanguageCode.
$wgGoogleAdSenseLanguage = "en"; (until 2.7.1)

// This can be anything you like. Default is 'none'.
$wgGoogleAdSenseID = 'none'; (until 2.7.1)

Werbeblöcke

Bis zu vier Werbeblöcke definieren:

$wgGoogleAdSense_AD1 = [ 'slotid 1', 145, 260 ];
$wgGoogleAdSense_AD2 = [ 'slotid 2', 145, 260 ];
$wgGoogleAdSense_Top = [ 'slotid 3', 145, 260 ];
$wgGoogleAdSense_Bottom = [ 'slotid 4', 145, 260 ];
$wgGoogleAdSense_AD1 = [ 'slotid 1', 145, 260, 'rectangle' ];
$wgGoogleAdSense_AD2 = [ 'slotid 2', 145, 260, 'horizontal' ];
$wgGoogleAdSense_Top = [ 'slotid 3', 145, 260, 'vertical' ];
$wgGoogleAdSense_Bottom = [ 'slotid 4', 145, 260, 'vertical, rectangle' ];

Ersetze den ersten Wert durch den AdSense-Anzeigenblock-ID (google_ad_slot / data-ad-slot) fĂŒr jeden Anzeigenblock. Die Slot ID fĂŒr das AdSense-Skript ist zum beispielsweise 1234580893.

Im zweiten und dritten Wert sind der width und der height der AdSense-Einheit anzugeben, die im AdSense-Konto spezifiziert sind (google_ad_width / data-ad-width, google_ad_height / data-ad-height). Werte wie 'auto', '100%', '60%' usw. sind zulĂ€ssig. Die vierte Variable fĂŒr data-ad-format ist optional.

Beispiel

Dieses Beispiel entspricht dem obigen Beispiel in Kapitel BannerCode:

$wgWimaAdvertising = false;
$wgGoogleAdSense = true;
$wgGoogleAdSenseClient = 'pub-9471398824076666';
$wgGoogleAdSense_AD1 = [ '3512091103', 145, 260 ];
$wgGoogleAdSenseSrc = '//pagead2.googlesyndication.com/pagead/js/adsbygoogle.js?client=ca-pub-9471398824076666';

Compatibility with more skins

You can use this extension with any skin. $wgSidebarAd1Code and $wgSidebarAd2Code only work if the activated skin has a sidebar. $wgBannerBottomCode and $wgBannerTopCode should always work. Only a present sidebar may require additional css support, which handles the background color of the slot and similar stuff.

You may avoid a PHP warning message by altering line 44 in file Hooks.php from

	} else if ( $skinname !== 'fallback' ) {

into

	} else if ( !in_array( $skinname, [ 'yourfavoriteskin', 'fallback' ] ) ) {

See also

Remarks

  • Branch REL1_25 for MediaWiki 1.23 up to 1.35.
    The branch REL1_25 was tested with the following MediaWiki versions: 1.23.17, 1.25.6, 1.31.16, 1.35.14
  • Branch REL1_35 for MediaWiki 1.35+.
    Die Abspaltung REL1_35 wurde mit den folgenden MediaWiki-Versionen getestet: 1.35.14, 1.39.8, 1.40.2, 1.41.2, 1.42.1
  • Version 2.1 has added support for Skin vector-2022.
  • Version 2.2 has added support for Skin Timeless.
  • Version 2.3 has added Hook SkinAfterPortlet for supporting MediaWiki 1.35+.
  • Version 2.4 has some Refactoring:
    Changed “configuration schema”, replaced manifest version 1 with version 2 and changed the prefix of the configuration variables from default to wm.
    Replaced class “WimaAdvertisingHooks” (extends “Hooks”) with class implements interfaces.
  • Version 2.4.1 contains a dirty hack for skin Timeless.
  • Version 2.5 places JavaScript for GoogleAdSense in ‎<head> section.
  • Version 2.6 allows the labeling of Wima slots to be set as `blank`.
  • Version 2.7 has added support for Skin Monaco.
    Note: To make the Ads in the Sidebar work is the use of a Fork of Skin Monaco needed!
  • Version 2.8 has changed code for GoogleAdSense, see
    • https_developers.google.com/adsense/host/adunits Ad Units and Code Generation
    • https_developers.google.com/adsense/platforms/transparent/ad-tags Ad tags
  • Version 2.8.5:
    Changed the prefix of the configuration variables back to wg.

Version 3.0

  • The version 3.0 (alpha) has a new approach, with click-away ads that are fixed and do not disappear when scrolling, and are (largely) independent of the skin.
  • At the moment only tested with MediaWiki version 1.39.1.
  • Download on GitHub (alpha Version)