=== Prosodia VGW OS === Contributors: raubvogel, smoo1337 Donate link: https://prosodia.de/ Tags: VG WORT, Zählmarke, Geld, Beitrag, T.O.M., Zählpixel, VGW, Verwertungsgesellschaft WORT, Prosodia Requires at least: 5.0 Tested up to: 5.9 Requires PHP: 7.0 Stable tag: 3.25.3 License: GPLv2 or later License URI: https://www.gnu.org/licenses/gpl-2.0.html Verdienen Sie mit Ihren Beiträgen/Texten Geld durch die Integration von Zählmarken der VG WORT. == Description == > Anleitungen
> Unter [https://prosodia.de/prosodia-vgw-os/](https://prosodia.de/prosodia-vgw-os/) gibt es Anleitungen zum Plugin. Das Plugin *Prosodia VGW OS* (open source) vom Literaturverlag [Prosodia](https://prosodia.de/) und die [Verwertungsgesellschaft WORT (VG WORT)](https://www.vgwort.de/die-vg-wort.html) ermöglichen es Ihnen, *jährlich Geld* mit Ihren in WordPress geschriebenen Beiträgen zu verdienen. Die VG WORT ist ein deutscher, rechtsfähiger Verein, in dem sich Autoren zur gemeinsamen Verwertung von Urheberrechten zusammengeschlossen haben. Derart können Sie mit Ihren [Texten im Internet (Beiträge)](https://www.vgwort.de/verguetungen/auszahlungen/texte-im-internet.html), die aus mindestens *1.800 Zeichen* bestehen, von der Verwertung (Geld, Tantiemen) Gebrauch machen. Dazu ist eine kostenlose Mitgliedschaft bei der VG WORT erforderlich: [kostenlose Anmeldung](https://tom.vgwort.de/portal/login). Jeder Beitrag, für den Sie jährlich Geld bekommen wollen, muss eine gewissen Zahl an Lesern/Zugriffen aufweisen. Die Anzahl der Zugriffe für einen Beitrag wird von der VG WORT über *Zählmarken* ermittelt. Dabei wird jedem Beitrag ein eindeutiger Code – eine Zählmarke – zugeordnet. Besucht ein Leser einen Beitrag, wird die dem Beitrag zugeordnete Zählmarke an die VG WORT übermittelt und somit die Gesamtzahl der Leser für diesen Beitrag erhöht. Einmal im Jahr wird dann *pro* Beitrag Geld an Sie ausgeschüttet, abhängig davon wie hoch die Leserzahl eines Beitrags im vorherigen Jahr gewesen ist – die notwendige Mindestzahl wird von der VG WORT festgelegt (siehe auch [Wikipedia](https://de.wikipedia.org/wiki/Meldesystem_f%C3%BCr_Texte_auf_Internetseiten)). Je nach dem wie viele Beiträge Sie verfasst haben und wie häufig diese gelesen wurden, ist ein Verdienst von jährlich mehreren hundert bis tausend Euro durchaus nicht utopisch. Die Hauptaufgabe von Prosodia VGW OS ist, Zählmarken und deren Zuordnungen zu Beiträgen bequem für Sie im WordPress-Administrationsbereich zu verwalten und sicherzustellen, dass keine Zählmarken verloren gehen oder mehrfach vergeben werden. Besonders dann, wenn Sie im Laufe der Zeit viele Texte mit Zählmarken versehen, werden Sie feststellen, dass eine manuelle Zuordnung durch direktes Einfügen der Zählmarken in Beiträgen in hinreichend großer Unüberschaubarkeit endet – dem wirkt Prosodia VGW OS durch Formalisierung und ausgeklügelter Technik entgegen. Im Folgenden werden die Funktionen und Fähigkeiten von Prosodia VGW OS kurz aufgelistet: * Übersicht aller Zählmarken, Zählmarken-Zuordnungen und weiterer Daten mit vielen Filter- und Sortierfunktionen * Massenbearbeitung von Zählmarken und Zählmarken-Zuordnungen * Integration in die Beitrags-Übersicht („Alle Beiträge“) von WordPress * automatisches Zuordnen von Zählmarken zu Beiträgen – auch massenhaft * Prüfen-Funktion, ob zugeordnete Zählmarke tatsächlich auf Webseite ausgegeben wird * Anzeige der Zeichenanzahl eines Beitrags sowie der Anzahl fehlender Zeichen beim Schreiben * Zeichenanzahl wird nach VG-WORT-Vorgabe berechnet – keine Bilder und Beschriftungen, Shortcodes, HTML-Tags usw. * es können Beitrags-Typen (Beiträge, Seiten usw.) für die Zählmarken-Funktion ausgewählt werden * private Zählmarken, Beitrags-Titel, -Texte und -Links können für eine Meldung schnell in die Zwischenablage kopiert werden * importieren von Zählmarken aus CSV-Dateien, die von der VG WORT bereitgestellt werden * importieren von Zählmarken aus CSV-Text oder manueller Eingabe * importieren von Zählmarken und Zählmarken-Zuordnungen aus dem Plugin „Worthy“ von B. Holzmüller * importieren von Zählmarken und Zählmarken-Zuordnungen aus dem Plugin „VG Wort“ von [Torben Leuschner](https://www.torbenleuschner.de/blog/922/vg-wort-wordpress-plugin/) * importieren von Zählmarken und Zählmarken-Zuordnungen aus dem Plugin „VG-Wort Krimskram“ von [Heiner Otterstedt](https://wordpress.org/plugins/vgw-vg-wort-zahlpixel-plugin/) * importieren von manuell zugeordneten Zählmarken aus Beiträgen – ``-Tag wird erkannt und optional gelöscht * nachträglicher Import von fehlenden privaten Zählmarken, falls die entsprechend öffentlichen bereits vorhanden sind * exportieren von Zählmarken, Zählmarken-Zuordnungen und weiterer Daten als CSV-Datei mit Filter- und Sortierfunktionen * Zählmarken (``-Tags) werden in den Beiträgen auf Ihrer Website ausgegeben * Unterstützung des Plugins [AMP](https://wordpress.org/plugins/amp/) für [Accelerated Mobile Pages](https://www.ampproject.org/) * Unterstützung des Plugins [AMP for WP – Accelerated Mobile Pages](https://wordpress.org/plugins/accelerated-mobile-pages/) für [Accelerated Mobile Pages](https://www.ampproject.org/) * Unterstützung des Plugins [WP AMP](https://codecanyon.net/item/wp-amp-accelerated-mobile-pages-for-wordpress-and-woocommerce/16278608) für [Accelerated Mobile Pages](https://www.ampproject.org/) * Unterstützung des Plugins [Advanced Custom Fields](https://de.wordpress.org/plugins/advanced-custom-fields/) * Ausgabe von Zählmarken in Feeds (RSS, Atom, RDF) möglich * Format der Zählmarkenausgabe kann frei angegeben werden (Platzhalter für Server und öffentliche Zählmarke) * Unterstützung der Übertragung von Zählmarken (``-Tags) über verschlüsselte Verbindungen (TLS/SSL, https) * Datenintegrität der Zählmarken und Zählmarken-Zuordnungen wird stets gewährleistet * Zählmarken und Zählmarken-Zuordnungen werden in eigener Datenbanktabelle gespeichert – hohe Leistung (getestet mit über 30.000 Beiträgen) * inaktiv setzen von Zählmarken – Zählmarken-Zuordnung wird nicht aufgehoben, Zählmarke wird nicht ausgegeben * nicht zuordenbar setzen von Zählmarken – Zählmarke kann dann nicht mehr zugeordnet werden (ist also reserviert) * Warnung wird ausgegeben, falls andere VG-WORT-Plugins aktiviert sind * Datenschutz-Vorlage für die Datenschutzerklärung Ihrer Website, wenn Sie Zählmarken der VG WORT verwenden * Plugin ist DSGVO-konform * kompatibel mit Gutenberg-Editor * Integration in die [WordPress-REST-API](https://developer.wordpress.org/rest-api/), um Zählmarken-Daten automatisiert abrufen zu können * Möglichkeit der vollständigen Deinstallation und Löschung der Datenbanktabellen und Einstellungen * läuft auf Multisite-Installationen Schauen Sie sich bitte auch die [Bildschirm-Fotos (Screenshots)](/plugins/wp-vgwort/screenshots/) von Prosodia VGW OS an. Das Plugin selbst wird mit stets aktuellen Software-Entwicklungswerkzeugen (für [PHP](https://php.net/)), Code-Überprüfungswerkzeugen und Code-Versionierungswerkzeugen in mehreren lokalen Entwicklungs- und Test-Umgebungen weiterentwickelt. Wir achten des Weiteren penibel darauf, dass keine PHP-Warnungen, -Hinweise und -Fehler durch unser Plugin im Normalbetrieb ausgegeben werden und dass wir uns stets an empfohlene Vorgehensweisen beim Entwickeln halten (dies scheint bei vielen Plugins leider nicht gängige Praxis zu sein). Daher sind wir – vermutlich zu recht – davon überzeugt, dass unser Plugin auch in Zukunft stabil und fehlerarm läuft. = Eignung = Was Prosodia VGW OS nicht leistet: * Differenzierung der Zählmarken zwischen den Autoren eines Blogs * keine direkte Interaktion mit [T.O.M.](https://tom.vgwort.de/portal/index), da von der VG WORT nicht unterstützt * keine Warnung, wenn nicht zugeordnete Zählmarken knapp werden * separate Behandlung von Lyrik (darf weniger als 1.800 Zeichen haben) * Zuordnung von Zählmarken zu PDFs * exklusiven Support – nur über die Community Für wen es ungeeignet ist: * für Blogs mit vielen Autoren * für Unternehmen * für Verlage Einige Funktionen – insbesondere die Autoren-Verwaltung – sind bereits in der Verkaufsversion „Prosodia VGW“ integriert, welche demnächst günstig vertrieben wird. = Kompatibilität = Technische Voraussetzungen für Prosodia VGW OS sind: * mindestens WordPress 5.0 * getestet bis PHP 8.0 = Lizenz = Prosodia VGW OS wird von der [Max Heckel, Ronny Harbich – Prosodia GbR](https://prosodia.de/kontakt/) unter der GPLv2-Lizenz vertrieben, die unter [https://www.gnu.org/licenses/gpl-2.0.html](https://www.gnu.org/licenses/gpl-2.0.html) nachzulesen ist. = Haftung = Die [Max Heckel, Ronny Harbich – Prosodia GbR](https://prosodia.de/kontakt/) übernimmt für Prosodia VGW OS keine Haftung außer die vom Bürgerlichen Gesetzbuch (BGB) zwingend erforderliche. Der Haftungsausschluss soll – soweit wie mit dem BGB vereinbar – der GPLv2-Lizenz entsprechen. = Hinweis = Prosodia VGW OS wird von der VG WORT weder unterstützt noch von ihr vertrieben. = Hilfe und Anleitungen = Unter [https://prosodia.de/prosodia-vgw-os/](https://prosodia.de/prosodia-vgw-os/) gibt es bebilderte Anleitungen zum Plugin. Wenn Sie einen Wunsch für eine neue Funktion haben oder Hilfe benötigen, treten Sie bitte mit uns in Kontakt: * [FAQ-Seite](/plugins/wp-vgwort/faq/) * [Support-Seite](/support/plugin/wp-vgwort) * E-Mail-Adressen befindet sich im Plugin unter „Prosodia VGW OS“ → „Hilfe“ == Installation == Automatische Installation über den Plugin-Bereich im Administrationsbereich von WordPress oder manuell wie folgt: 1. Laden Sie die Plugin-Zip-Datei herunter. 1. Entpacken Sie die Zip-Datei ins WordPress-Plugin-Verzeichnis (wp-content/plugins/). 1. Aktivieren Sie das Plugin im Plugin-Bereich im Administrationsbereich. == Frequently Asked Questions == = Anleitungen = Unter [https://prosodia.de/prosodia-vgw-os/](https://prosodia.de/prosodia-vgw-os/) gibt es bebilderte Anleitungen zum Plugin. = Aktualisierung auf Version 3.0.0 oder höher = Da das Plugin ab Version 3.0.0 vollständig neu entwickelt wurde, ist es nicht mehr direkt mit den vorherigen Versionen kompatibel. Allerdings werden sämtliche Daten und Einstellungen aus den Vorgängerversionen nach der Aktualisierung übernommen – insbesondere die Zählmarken und deren Zuordnungen zu Beiträgen. Dies funktioniert nicht vollautomatisch, sondern erst nach einigen, wenigen Mausklicks. So werden nach der Aktualisierung im Administrationsbereich einige Warnungen angezeigt. Diese Warnungen enthalten Anweisungen und Links, wie die dargelegten Sachverhalte zu lösen sind – keine Sorge, dies ist mit wenigen Mausklicks erledigt. Und selbst wenn dabei etwas schief gehen sollte – wovon wir nicht ausgehen –, werden die alten Daten und Einstellungen nicht gelöscht. Das Einsetzen einer Version vor 3.0.0 ist stets möglich: [alte Versionen](/plugins/wp-vgwort/developers/). Sollte das Plugin die ältere Version nicht erkennen, so führen Sie bitte manuell „Prosodia VGW OS“ → „Operationen“ → „Zählmarken aus altem VG-WORT-Plugin vor Version 3.0.0 importieren“ (Haken setzen) → „Alte Zählmarken und Zählmarken-Zuordnungen importieren“ (Schaltfläche) aus. = „Parse error“ nach Update auf Version 3.0.0 oder höher = Es erscheint der Fehler `Parse error: syntax error, unexpected T_FUNCTION, expecting ')' in …` nach dem Update des Plugins auf Version 3.0.0 oder höher. Dieser tritt in der Regel auf, wenn eine PHP-Version kleiner als 5.3 eingesetzt wird. Das Plugin setzt allerdings mindestens Version 5.3 voraus. Um das Problem zu beheben, sollten Sie sich an Ihren Systemadministrator wenden (siehe auch [PHP auf der englischen Wikipedia](https://en.wikipedia.org/wiki/PHP#Release_history)). = Es werden keine Zählmarken aus CSV-Dateien importiert = Die Spalten der [CSV-Dateien](https://de.wikipedia.org/wiki/CSV_%28Dateiformat%29), die von der VG WORT heruntergeladen werden können, sind mit Semikolon (;) getrennt. Werden CSV-Dateien mit [LibreOffice Calc](https://de.libreoffice.org/) oder Microsoft Excel geöffnet und wieder abgespeichert, kann es ja nach Einstellung vorkommen, dass das Semikolon durch einen Tabulator, Komma oder anderes Zeichen ersetzt wird. In diesem Fall kann das Plugin die Zählmarken in der CSV-Datei nicht mehr erkennen. Bitte verwenden Sie ausschließlich unveränderte CSV-Dateien für den Import. = Zählmarken lassen sich nicht beim Bearbeiten eines Beitrags einfügen = Im Gegensatz zur alten Plugin-Versionen sind die Felder im Bereich „Zählmarke für VG WORT“ beim Bearbeiten eines Beitrags nicht dazu da, um Zählmarken in das System einzufügen / zu importieren, sondern dienen lediglich der Zuordnung. Hier dürfen nur bereits importierte Zählmarken angeben werden. Normalerweise findet die Zuordnung durch Setzen des Häkchens „Zählmarke automatisch zuordnen“ (Standardeinstellung) automatisch statt. Am besten, Sie verfahren so: Importieren Sie zunächst Zählmarken der VG WORT als CSV-Datei unter „Import“. Dann sind neue Zählmarken im System. Als nächstes gehen Sie zum Beitrag und weisen diesem automatisch eine neue Zählmarke zu. Eine manuelle Zuordnung ist ebenfalls möglich: Dazu können Sie die bereits importierte, öffentliche Zählmarke angeben (die private findet das Plugin automatisch). Öffentliche Zählmarken sind Codes wie „00a0f12e1113423cc56ff5“ und keine ``-HTML-Tags wie ``. Zusammenfassend: unbenutzte Zählmarken von der VG WORT importieren, dann automatisch zu Beiträgen zuordnen lassen. = Zeichenanzahl wird bei Verwendung von Shortcodes falsch berechnet = Es besteht die Möglichkeit, die Einstellung „Prosodia VGW OS“ → „Operationen“ → „Shortcodes bei Berechnung der Zeichenanzahl auswerten“ zu aktivieren. Dann werden die Shortcodes in einem Beitrag aufgelöst und die Anzahl der Zeichen der Ausgabe der Shortcodes mitberechnet. Dies funktioniert allerdings nur, wenn der jeweilige Shortcode auch im Administrationsbereich aufgelöst werden kann. Plugins haben die Möglichkeit, ihre Shortcodes nur auf der eigentlichen Website – also nicht im Administrationsbereich – auflösen zu lassen. In diesem Fall kann Prosodia VGW OS die Ausgabe der Shortcodes nicht erhalten und folglich auch nicht die korrekte Zeichenanzahl bestimmen. Zur Zeit ist uns für dieses Problem leider keine Lösung bekannt. Davon abgesehen, kann stets eine Zählmarke zugeordnet werden, auch wenn die nötige Zeichenanzahl nicht erreicht wurde bzw. nicht korrekt ermittelt werden konnte. == Screenshots == 1. Zählmarken und Export. 2. Import von Zählmarken. 3. Einstellungen. 4. Komplexe Operationen und Einstellungen. 5. Integration in der Beitragsübersicht von WordPress (Spalte „Zeichen“, Filter) 6. Integration beim Bearbeiten eines Beitrags. 7. Zählmarkenausgabe (markiert) im HTML-Quelltext eines Beitrags. == Changelog == = 3.25.3 = * Fehler bez. aufwendiger Operationen behoben. = 3.25.2 = * Fehler bez. Zählmarke (in-)aktiv setzen behoben. = 3.25.1 = * Fehler bez. Seitentyp-Erkennung behoben. = 3.25.0 = * Medien (z. B. PDF) können nun Zählmarken zugeordnet werden (nicht für AMP). * Zählmarkenausgebe-Format verbessert (referrerpolicy). Warnung hinzugefügt, falls das eingestellte Zählmarken-Ausgabe-Format vom Standardwert abweicht (abstellbar). * VG-WORT-Datenschutz-Hinweis für Datenschutzerklärung aktualisiert. * Begriff „Beitrag“ plugin-weit durch „Seite“ ersetzt. * Kompatibilität zu WordPress 5.7 getestet. * Diverse Quellcode-Verbesserungen. * Diverse Fehlerbehebungen. = 3.24.11 = * Plugin erneut auf wordpress.org hochgeladen. = 3.24.10 = _Update empfohlen._ * Fehler (Klasse „WPVGW“ nicht gefunden) in Bezug auf PHP 8.0 behoben. = 3.24.9 = * Problem behoben, dass aufgrund restriktiver Datenbankkonfiguration auftreten konnte (`SQL_BIG_SELECTS` in MySQL). = 3.24.8 = * Fehler Umbenennung von `cleanWordPressText()` behoben. = 3.24.7 = * Fehler im Build-System behoben, der den Quellcode falsch formatiert hat. = 3.24.6 = * Kompatibilität zu WordPress 5.6 und PHP 8.0 hergestellt. Code-Verbesserungen. = 3.24.5 = * Methode verbessert, den Block-Editor zu erkennen. = 3.24.4 = * WordPress-Filter `deny_get_marker_data` hinzugefügt. = 3.24.3 = * Fehler behoben. = 3.24.2 = * Notwendige Mindestversion von PHP auf 7.0 gesetzt. = 3.24.1 = * Fehler behoben, der in der Zählmarken-Übersicht bei der Suche auftrat. = 3.24.0 = * Integration in die [WordPress-REST-API](https://developer.wordpress.org/rest-api/), um Zählmarken-Daten automatisiert abrufen zu können. = 3.23.0 = _Update empfohlen._ * Berechnung der Zeichenanzahlen verbessert. * Kompatibilität mit WordPress 5.5 getestet. * Sicherheit für AJAX-Aufrufe verbessert. * Code-Qualität an einigen Stellen erhöht. = 3.22.10 = * Lizenztext geändert. Lizenzrestriktionen entfernt. = 3.22.9 = * Fehler behoben. = 3.22.8 = * Fehler behoben. = 3.22.7 = * Fehler behoben (`'AMPHTML'`). = 3.22.6 = * Die Zeitspanne für die automatische Aktualisierung der Anzeige der Zeichenanzahl im Beitrags-Editor kann nun eingestellt werden (Deaktivierung auch möglich). * CSS-Klasse `wpvgw-marker-image` im `img`-Tag für Zählmarkenausgabe hinzugefügt. Kann z. B. für Ausnahmeregeln in Lazy-Load-Plugins verwendet werden. * Kompatibilität mit fehlerhaften Shortcodes diverser Plugins verbessert (Teil 3). = 3.22.5 = * Kompatibilität mit fehlerhaften Shortcodes diverser Plugins verbessert (Teil 2). = 3.22.4 = * Kompatibilität mit fehlerhaften Shortcodes diverser Plugins verbessert. = 3.22.3 = _Update empfohlen._ * Standard-Ausgabe für Zählmarken in Bezug auf Lazy-Loading-Plugins verbessert (`loading="eager"` und `data-no-lazy="1"` hinzugefügt). = 3.22.2 = * Es werden nun auch dynamische Felder des Plugins [Advanced Custom Fields](https://de.wordpress.org/plugins/advanced-custom-fields/) (ACF) bei der Berechnung der Zeichenanzahl berücksichtigt. * Plugin-Namen geändert auf „Prosodia VGW OS“. * Position von „Prosodia VGW OS“ im WordPress-Menü hinter „Einstellungen“ verschoben. = 3.22.1 = _Update empfohlen._ * VG-WORT-Datenschutzerklärung zur Website-Integration aktualisiert. Bitte auf Website anpassen! Es erscheint eine entsprechende Warnung. = 3.22.0 = * Unterstützung für das Plugin [Advanced Custom Fields](https://de.wordpress.org/plugins/advanced-custom-fields/) (ACF) hinzugefügt. Die Zeichenanzahl von ACF-Feldern kann nun zur Zeichenanzahl des Beitrags addiert werden (muss pro ACF-Feld aktiviert werden). * Zusätzliche `