WordPress-Plugin

1. 1. Lade oben die ZIP-Datei herunter.
2. 2. Geh auf deiner Website zu Plugins → Add New Plugin → Upload Plugin, wähl die heruntergeladene Datei aus und klick auf Install Now.
3. 3. Aktivier das Plugin, geh dann zu Settings → Occult API und füg deinen Schlüssel ein.
4. 4. Klick auf Verify key – das kostet keine Credits – und füg dann auf einer beliebigen Seite einen Block ein.

Jeder Block registriert einen gleichnamigen Shortcode – für den klassischen Editor, einen Widget-Bereich oder einen Aufruf von do_shortcode() in einer Template-Datei. Ohne Attribute greift jeder Shortcode auf die Standardwerte aus Settings → Occult API zurück.

[occult_panchang]

Panchang und die Zeit-Blöcke nehmen optional einen Ort und ein Datum; Rashifal nimmt ein Tierkreiszeichen und einen Zeitraum.

[occult_panchang place="Varanasi" date="2026-10-02"]

[occult_rahu_kaal latitude="25.3176" longitude="82.9739" timezone="Asia/Kolkata"]

[occult_rashifal sign="aries" period="daily"]

Die komplette Liste, einer pro Block:

[occult_panchang]
[occult_rahu_kaal]
[occult_choghadiya]
[occult_abhijit_muhurat]
[occult_brahma_muhurat]
[occult_durmuhurat]
[occult_ekadashi]
[occult_amavasya]
[occult_purnima]
[occult_pradosh]
[occult_sankashti]
[occult_festivals]
[occult_rashifal]
[occult_kundli]

Jeder Block ist nur eine dünne Darstellungsschicht über denselben Endpoints, die an anderer Stelle auf dieser Website dokumentiert sind. Er ruft die API auf dem Server auf, cacht die Antwort und formatiert sie. Einen Winkel oder ein Tithi berechnet er nie selbst – deshalb kann er einem direkten API-Aufruf mit denselben Eingaben nie widersprechen.

Die Berechnungen laufen über dein eigenes Konto, ein Credit pro Berechnung. Das Plugin cacht die Antworten, sodass sich alle Besucher einen Aufruf teilen, statt dass jeder einzeln bezahlt: Ein Panchang-Block bleibt sechs Stunden im Cache und kostet daher höchstens vier Credits pro Tag und angezeigtem Ort – egal, wie viele Besucher die Seite laden. Nur über das Kundli-Formular kann ein Besucher einen Credit verbrauchen, deshalb gilt dort ein Rate-Limit pro IP-Adresse.

Das brauchst du nur für etwas, das die Blöcke nicht abdecken – ein individuelles Layout oder einen Endpoint ohne eigenen Block. Sobald das Plugin eingerichtet ist, liegt der Schlüssel in get_option('occult_api_key'). Eigener Code kann also denselben gespeicherten Schlüssel nutzen, statt eine zweite Kopie fest einzubauen.

$response = wp_remote_post('https://api.occultapi.com/api/astro/rashifal/daily/', [
  'headers' => [
    'X-API-Key' => get_option('occult_api_key'),
    'Content-Type' => 'application/json',
  ],
  'body' => json_encode(['rashi' => $sign]),
]);

Cache das Ergebnis. Ein Transient, dessen Name aus den Eingaben gebildet wird, macht aus einem Credit pro Besucher einen Credit pro Stunde – die Blöcke machen intern genau dasselbe.

$cached = get_transient('occult_horoscope_' . $sign);
if (false === $cached) {
  $response = wp_remote_post('https://api.occultapi.com/api/astro/rashifal/daily/', [
    'headers' => [
      'X-API-Key' => get_option('occult_api_key'),
      'Content-Type' => 'application/json',
    ],
    'body' => json_encode(['rashi' => $sign]),
  ]);
  $cached = json_decode(wp_remote_retrieve_body($response), true);
  set_transient('occult_horoscope_' . $sign, $cached, HOUR_IN_SECONDS);
}