Plugin WordPress

1. 1. Téléchargez le zip ci-dessus.
2. 2. Sur votre site, allez dans Plugins → Add New Plugin → Upload Plugin, choisissez le fichier téléchargé, puis cliquez sur Install Now.
3. 3. Activez le plugin, puis allez dans Settings → Occult API et collez votre clé.
4. 4. Cliquez sur Verify key — cela ne coûte aucun crédit — puis ajoutez un bloc à n’importe quelle page.

Chaque bloc enregistre un shortcode du même nom, utilisable dans l’éditeur classique, dans une zone de widgets ou via un appel à do_shortcode() dans un fichier de modèle. Sans attributs, chacun reprend les valeurs par défaut définies dans Settings → Occult API.

[occult_panchang]

Le Panchang et les blocs d’horaires acceptent un lieu et une date facultatifs ; le Rashifal prend un signe et une période.

[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"]

La liste complète, un par bloc :

[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]

Chaque bloc n’est qu’une fine couche d’affichage au-dessus des endpoints documentés ailleurs sur ce site. Il appelle l’API côté serveur, met la réponse en cache et la met en forme. Il ne calcule jamais lui-même un angle ou une tithi : il ne peut donc jamais contredire un appel direct à l’API avec les mêmes entrées.

Les calculs sont facturés sur votre propre compte, un crédit chacun, et le plugin met les réponses en cache pour que les visiteurs partagent un même appel au lieu de payer chacun le leur. Un bloc Panchang reste six heures en cache : il coûte donc au plus quatre crédits par jour pour chaque lieu affiché, quel que soit le nombre de visiteurs qui chargent la page. Le formulaire Kundli est le seul élément sur lequel un visiteur peut dépenser un crédit ; son débit est donc limité par adresse IP.

Ce n’est utile que pour ce que les blocs ne couvrent pas : une mise en page sur mesure, ou un endpoint qui n’a pas de bloc. Une fois le plugin configuré, la clé se trouve dans get_option('occult_api_key') : votre code peut donc réutiliser la clé enregistrée au lieu d’en coder une seconde copie en dur.

$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]),
]);

Mettez en cache. Un transient indexé sur les entrées transforme un crédit par visiteur en un crédit par heure, et les blocs font la même chose en interne.

$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);
}