[TiSiE] Blog

Beschreibung

Fügt Template-Tags zu einem WordPress-Blog, die Daten (Veröffentlichungsdatum, Änderungsdatum und Kommentardatum) relativ zum aktuellen Datum aus- oder zurückgeben. Solche Ausgaben sind z.B. “3 Monaten und 2 Tagen” oder “4 Monaten, 2 Wochen, 5 Tagen, 10 Stunden und 2 Minuten”

Im Gegensatz zu anderen Algorithmen, die relative Zeitangaben berechnen, basiert der von diesem Plugin verwendete auf der schriftlichen Subtraktion und ist deswegen synchron zum gregorianischen Kalendersystem. Wenn also heute der 01.03.2010 und das Veröffentlichungsdatum des Artikels der 01.02.2010 wäre, dann wäre 1 Monat die berechnete Zeitangabe.

Zur Zeit gibt es das Plugin mit deutschen und englischen Zeiteinheiten. Aber wenn Du mir helfen willst, es in mehr Sprachen zu lokalisieren, werde ich diese Übersetzungen freudig hinzufügen. (mehr Infomrationen in der FAQ)

Die folgenden Tags sind verfügbar

• the_date_relative / get_the_date_relative
• the_modified_date_relative / get_the_modified_date_relative
• comment_date_relative / get_comment_date_relative

Zuzsätzlich sind folgende Filter Hooks verfügbar

• tirt_get_string
• tirt_get_array

Das ist eine BETA-Release, also wenn irgendwas nicht wie erwartet funktioniert, oder du anderer Fehler und Komplikationen mit anderen Plugins feststellst, bitte melde diese bei mir, damit ich das Plugin reparieren und weiterentwickeln kann.

Installation

1. Plugin vom WordPress Plugin Directory herunterladen
2. Zip-Datei in Dein Plugin-Ordner hochladen und entpacken.
3. Plugin auf der Plugin-Verwaltungsseite aktivieren.
4. Die Template-Tags in Deine Theme-Dateien einfügen. (siehe Gebrauchsanleitung
5. (Optional) Benutze die Filter Hooks, um die Ausgabe zu modifizieren, ohne die Plugin-Dateien ändern zu müssen.

Das Plugin hat keine Einstellungen.

FAQ

Wie übersetze ich das Plugin in andere Sprachen?

Editiere die Datei “tirt.pot” im Unterverzeichnis “translations” des Plugin-Wurzelverzeichnisses und füge den übersetzten String zwischen die beiden Anführungszeichen in jeder “msgstr”-Zeile.
Speichere die editierte Datei als “tirt-[sprachkürzel].po” und konvertiere diese Datei mit Hilfe von “gettext” zu einer .mo-Datei.

Oder benutze poedit: Lade die Datei “tirt.pot” als neuen Katalog, übersetze die Strings und speichere als “tirt-[sprachkürzel].po”. poedit erstellt automatisch die .mo-DateiOr use poedit: Load the tirt.pot file as new catalog, translate the strings and

[sprachkürzel] ist das ISO Sprachkürzel, wie z.B. “en_EN” oder “de_DE”.

Screenshots

Change Log

0.2

• fixed: Das Datum wurde nicht geprüft.
• neu: Fehlerbehandlung. Benutzt jetzt WP_Error-Objekte, um Fehler anzuzeigen.
• neu: Zwei Filter Hooks: tirt_get_string and tirt_get_array

0.1

• Beta-Release

Upgrade Meldungen

0.2

• Das Datum wurde nicht geprüft, dadurch konnte es zum Absturz des gesamten Blogs kommen.

  Du brauchst aber nicht unbedingt upgraden, wenn du “tirt_get_string” oder “tirt_get_array” nicht direkt benutzt. – Es sei denn, du willst die neuen Feature benutzen.

Gebrauchsanleitung

Alle Template-Tags akzeptieren einen optionalen Parameter, der angibt, wieviele Zeiteinheiten angezeigt werden sollen.

Dieser Parameter muss eine Ganzzahl zwischen 1 und 7, inklusive, sein. Der Standard-Wert ist 2.

Um Zeitangaben wie “1 Jahr, 3 Stunden und 2 Minuten” zu verhindern, werden Zeiteinheiten, die einen Wert von 0 haben, und alle folgenden Zeiteinheiten nicht angezeigt – ganz egal welchen Wert der optionale Parameter hat.

Einzige Ausnahme davon ist die Zeiteinheit “Woche”. Denn Zeitangeben wie “1 Monat und 3 Tage” sind auch noch in Ordnung.

Beispiele:

• the_date_relative(1)

  “1 Jahr”, “3 Tagen”

• the_date_relative(3)

  “1 Jahr, 2 Monaten und 4 Wochen”, “12 Tagen, 3 Stunden und 37 Minuten”, “4 Tagen” (- wenn Stunden 0 ist.)

Template Tags

• the_date_relative

  zeigt die relative Zeitangabe des Veröffentlichungsdatums an.

  Benutzung: <?php the_date_relative($parts) ?>

• get_the_date_relative

  gibt die relative Zeitangabe des veröffentlichungsdatums als String zurück.

  Benutzung: <?php $rel = get_the_date_relative($parts) ?>

• the_modified_date_relative

  zeigt die relative Zeitangabe des Änderungsdatums aus.

  benutzung: <?php the_modified_date_relative($parts) ?>

• get_the_modified_date_relative

  gibt die relative Zeitangabe des Änderungsdatums als String zurück.

  Benutzung: <?php $rel = get_the_modified_date_relative($parts) ?>

• comment_date_relative

  zeigt das Kommentardatum als relative Zeitangabe an.

  Benutzung: <?php comment_date_relative($parts) ?>

• get_comment_date_relative

  gibt das Kommentardatum als relative Zeitangabe zurück.

  Benutzung: <?php $rel = get_comment_date_relative($parts) ?>

zusätzliche Funtionen

Wenn Du, warum auch immer, ein Datum hast, das Du gerne als relative Zeitangabe ausgegeben haben möchtest, kannst du die folgenden Funktionen verwenden:

• <?php tirt_get_string($date, $parts) ?>

  gibt eine relative Zeitangabe zurück.

  Parameters:

  • $date (string) Das Datum, daß relativ angegeben werden soll. Im Mysql DateTime Format (YYYY-MM-DD HH:II:SS)
  • $parts (int) (optional) Wieviele Zeiteinheiten sollen angegeben werden (Default: 2)

• <?php tirt_get_array($date) ?>

  gibt die relativen Zeiteinheiten als Array zurück. array( 'year' => <value>, 'month' => <value>, 'week' => <value>, 'day' => <value>, 'hour' => <value>, 'minute' => <value>, 'second' => <value> );

  Parameters:

  • $date (string) Das Datum, das relative angegeben werden soll. Im Mysql DateTime Format.

Filter Hooks

Für generelle Informationen, wie Filter Hooks funktionieren, besuche bitte die Funktions-Referenz

• tirt_get_array

  wird am Ende von tirt_get_array angewandt.
  Kann dazu benutzt werden, um die Werte des Arrays zu ändern.

  Bemerkung:

  Die Filterfunktion muss ein Array zurückgeben, daß die selben Schlüssel enthält.

• tirt_get_string

  wird auf den relativen zeit string angewendet.
  Kann dazu benutzt werden, um Prefixe oder Postfixe an den String anzuhängen, wenn du das nicht bei jedem Vorkommen eines Template-Tags in deinen Theme- Dateien machen willst.