Plugin de WordPress

1. 1. Descarga el zip de arriba.
2. 2. En tu web, ve a Plugins → Add New Plugin → Upload Plugin, elige el archivo que has descargado y pulsa Install Now.
3. 3. Activa el plugin, ve a Settings → Occult API y pega tu clave.
4. 4. Pulsa Verify key (no gasta créditos) y añade un bloque a cualquier página.

Cada bloque registra un shortcode con el mismo nombre, para usarlo en el editor clásico, en un área de widgets o con do_shortcode() en un archivo de plantilla. Si no le pasas atributos, usa los valores por defecto de Settings → Occult API.

[occult_panchang]

Panchang y los bloques de horarios aceptan, de forma opcional, un lugar y una fecha; Rashifal acepta un signo y un periodo.

[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 lista completa, uno por bloque:

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

Cada bloque se limita a mostrar los resultados de los mismos endpoints que se documentan en el resto de este sitio. Llama a la API desde el servidor, guarda la respuesta en caché y le da formato. Nunca calcula por su cuenta un ángulo ni un tithi, así que con los mismos datos jamás puede contradecir una llamada directa a la API.

Los cálculos se cobran en tu propia cuenta, a un crédito cada uno, y el plugin guarda las respuestas en caché para que los visitantes compartan una misma llamada en vez de pagar cada uno la suya. Un bloque de Panchang se guarda seis horas en caché, así que cuesta como mucho cuatro créditos al día por cada lugar que muestre, da igual cuántos visitantes abran la página. El formulario de kundli es lo único con lo que un visitante puede gastar un crédito, por eso tiene un límite de solicitudes por dirección IP.

Solo hace falta para algo que los bloques no cubren: un diseño a medida o alguno de los endpoints que no tienen bloque. Una vez configurado el plugin, la clave está en get_option('occult_api_key'), así que tu propio código puede usar esa misma clave en vez de llevar otra copia escrita a mano.

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

Guarda la respuesta en caché. Un transient cuya clave dependa de los datos de entrada convierte un crédito por visitante en un crédito por hora; los bloques hacen lo mismo por dentro.

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