Der Veranstaltungskalender von Modern Tribe ist wahrscheinlich das beliebteste Kalender-Plugin für WordPress. Ich habe in einem früheren Beitrag über das Abfragen von Ereignissen mit WP_Query gesprochen, aber das gilt sowohl für die kostenlose als auch für die Premium – Version.
Die Premium-Version bietet viele großartige Funktionen, aber wenn Sie den Kalender programmgesteuert manipulieren möchten, ist es etwas schwieriger, damit zu arbeiten.
- Es gibt keine klare Dokumentation darüber, wie bestimmte Funktionen aus der Sicht eines Entwicklers genutzt werden können
- die Stellen, an denen gefragt wurde, wie das geht, lassen gelegentlich zu wünschen übrig.
Typisches Beispiel: Wenn wir wiederkehrende Ereignisse programmgesteuert erstellen müssen.
Um fair zu sein, denke ich, dass das Plugin für Benutzer im Gegensatz zu Entwicklern ist, und daher ist das Bereitstellen von Dokumentation darüber, wie man einen Aspekt seines internen Codes nutzt, keine Verpflichtung ihrerseits.
Zweitens ist es Open Source. Für diejenigen von uns, die einen Teil des Codes aufrufen müssen, Zeit haben und einen Debugger zur Hand haben, ist es nicht allzu schwierig, sich hinzusetzen und zu sehen, wie es funktioniert.
Der Vorteil von Open Source, oder?
Vor diesem Hintergrund erfordert die Methode zum programmgesteuerten Erstellen wiederkehrender Ereignisse mit dem Ereigniskalender, dass wir die Tribe__Events__Pro__Recurrence__MetaKlasse verwenden.
Dies setzt voraus, dass Sie die neueste Version des Plugins verwenden (zum Zeitpunkt dieses Beitrags) und dass Sie mit dem Warteschlangenmechanismus vertraut sind, der in das Plugin integriert ist. Ich werde dies nach dem folgenden Code näher behandeln.
Um ein wiederkehrendes Ereignis zu erstellen, benötigen Sie Folgendes:
- die Art des wiederkehrenden Ereignisses,
- wie es enden wird,
- das Startdatum,
- das Enddatum.
Der Rest kann eine Reihe von Standardwerten sein. Dann geht es darum, eine Instanz zu einer Klasse zu greifen, die Werte zu setzen und eine Methode aufzurufen.
Beachten Sie, dass der erste Parameter der updateRecurrenceMetaFunktion davon ausgeht, dass Sie die ID eines Ereignisses haben (die abgerufen wird, wenn Sie zum ersten Mal ein Ereignis erstellen).
Zweitens kann es abhängig von der Anzahl der Ereignisse, an denen Sie arbeiten, einige Minuten dauern, bis alle in der Datenbank erstellt sind. Dies liegt an der Art und Weise, wie das Plugin eine Reihe von Ereignissen in die Warteschlange stellt.
Anstatt sie alle auf einmal zu erstellen, werden die Ereignisse serialisiert und dann in Stapeln erstellt. Dies ist eine intelligente Art, damit umzugehen. Und wenn Sie es programmgesteuert nutzen möchten, ist dies eine Möglichkeit, all diese Funktionen kostenlos zu erhalten.