WordPress plugin

1. 1. Download the zip above.
2. 2. In your site, go to Plugins → Add New Plugin → Upload Plugin, choose the file you downloaded, then Install Now.
3. 3. Activate the plugin, then go to Settings → Occult API and paste in your key.
4. 4. Press Verify key — this costs no credits — then add a block to any page.

Every block registers a shortcode under the same name, for the Classic Editor, a widget area, or a call to do_shortcode() in a template file. With no attributes each one falls back to the defaults set in Settings → Occult API.

[occult_panchang]

Panchang and the timing blocks take an optional place and date; Rashifal takes a sign and a period.

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

The full set, one per 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]

Every block is a thin renderer over the same endpoints documented elsewhere on this site. It calls the API server-side, caches the response, and formats it — it never computes an angle or a tithi itself, so it can never disagree with a direct API call for the same input.

Calculations are billed to your own account, one credit each, and the plugin caches aggressively so the same page does not pay for the same answer twice — a Panchang block costs one credit a day regardless of how many visitors load the page. The Kundli form is the one thing a visitor can spend a credit on, so it is rate limited per IP address.

Only needed for something the blocks do not cover — a bespoke layout, or one of the endpoints that has no block. The key lives in get_option('occult_api_key') once the plugin is configured, so custom code can share the same stored key rather than hard-coding a second copy of it.

$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 it. A transient keyed by the inputs turns one credit a visitor into one credit an hour, and the blocks do the same thing internally.

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