====== keyworddensity ======

===== Installation =====

Zur Installation des Moduls können Sie die benötigten Dateien entweder über das TYPOlight-Extension-Repository direkt im TYPOlight-Backend laden,oder Sie kopieren die Dateien per Hand in Ihre TYPOlight-Installation. Dabei muss der Ordner "keywordDensity" im Order system/modules platziert werden.

Bei der manuellen Installation ist es außerdem nötig, von Hand auch die Erweiterung "ajax" zu installieren. Bei der Installation über das TYPOlight-Backend wird diese Abhängigkeit automatisch berücksichtigt.

Nach dem Hochladen der Dateien muss noch ein Datenbank-Update durchgeführt werden.

===== Inbetriebnahme =====

1. Bevor Sie die Dichte von Stichwörtern bestimmen können, müssen Sie noch Grenzwerte für die relative Häufigkeit der Stichwörter angeben. Unter dem Backend-Menüpunkt "Einstellungen" finden Sie in der Rubrik "Keyword-Dichte" vier Eingabefelder. Diese erwarten die Eingabe von Prozentsätzen.
Dabei bezieht sich die Zahl jeweils auf den prozentuellen Anteil des Wortes, das Sie später angeben, an der Gesamtmenge des Textes.

Dabei gilt
  * Alles, was prozentual unter der ersten oder über der letzten Zahl liegt,  wird mit rot (problematisch) gekennzeichnet.
  * Alles, was prozentual zwischen der ersten und der zweiten oder der dritten und vierten Zahl liegt, wird mit gelb (grenzwertig) gekennzeichnet.
  * Alles, was prozentual zwischen der zweiten und der dritten Zahl liegt, wird mit grün (optimal) gekennzeichnet.\\

Ein Beispiel: 2, 3, 5, 8

Wenn ein Wort weniger als zwei Prozent des Textes ausmacht, oder mehr als acht, wird es als problematisch markiert. Zwischen zwei und drei Prozent, oder fünf und acht Prozent, wird als grenzwertig betrachtet. Nur wenn ein Wort zwischen drei und fünf Prozent des Textes ausmacht, ist es optimal.

2. Als nächstes können Sie pro Artikel in den Eigenschaften (Rechtsklick auf "Bearbeiten"-Symbol in der Artikelübersicht) in der Rubrik "Keywords für SEO" bis zu drei Stichwörter angeben. Neben jedem Artikel erscheint nun in der Übersicht ein kleines Icon. Dieses kann verschiedene Zustände annehmen:
  * Ist das Icon mit einem grauen Button versehen, so sind keine Stichwörter definiert.
  * Ist das Icon mit einem roten Button versehen, so ist der Status problematisch.
  * Ein Icon mit einem gelben Button signalisiert den Status "grenzwertig".
  * Ein grüner Button beim Icon zeigt an, dass alle Werte im optimalen Bereich liegen.

Durch einen Klick auf das Icon (bei grauen Icons nicht möglich) in der Übersicht, oder durch einen Klick auf das Icon im Kopfbereich eines einzelnen Artikels, gelangen Sie zu einer Liste der angegebenen Stichwörter mit den jeweils errechneten Prozentzahlen.

3. Anhand dieser Zahlen können Sie nun gegebenenfalls Ihren Text überarbeiten.

===== Statusaktualisierung =====

Wenn Sie in den Einstellungen die Zahlen für das Rating anpassen, so basieren alle Statistiken noch auf den alten Zahlen. Um diese zu aktualisieren, müssen Sie jeden Artikel kurz über die "Bearbeiten"-Funktion öffenen, dadurch werden die Zahlen neu errechnet.