Plugin para WordPress

1. 1. Baixe o zip acima.
2. 2. No seu site, vá em Plugins → Add New Plugin → Upload Plugin, escolha o arquivo baixado e clique em Install Now.
3. 3. Ative o plugin, vá em Settings → Occult API e cole a sua chave.
4. 4. Clique em Verify key — isso não gasta créditos — e adicione um bloco a qualquer página.

Cada bloco registra um shortcode com o mesmo nome, para usar no Classic Editor, numa área de widgets ou numa chamada a do_shortcode() num arquivo de template. Sem atributos, cada um usa os padrões definidos em Settings → Occult API.

[occult_panchang]

O Panchang e os blocos de horários aceitam um local e uma data, ambos opcionais; o Rashifal aceita um signo e um período.

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

A lista completa, um por bloco:

[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 bloco é só uma camada fina de exibição sobre os mesmos endpoints documentados no resto deste site. Ele chama a API no servidor, guarda a resposta em cache e formata o resultado — nunca calcula um ângulo ou um tithi por conta própria. Por isso, nunca diverge de uma chamada direta à API com os mesmos dados.

Os cálculos são cobrados na sua própria conta, um crédito cada, e o plugin guarda as respostas em cache para os visitantes compartilharem uma chamada, em vez de cada um pagar a sua. Um bloco de Panchang fica seis horas em cache, então custa no máximo quatro créditos por dia para cada local exibido, não importa quantos visitantes abram a página. O formulário de kundli é o único ponto em que um visitante pode gastar crédito, por isso ele tem limite de requisições por endereço IP.

Só é preciso para algo que os blocos não cobrem — um layout sob medida ou um endpoint que não tem bloco. Com o plugin configurado, a chave fica em get_option('occult_api_key'), então seu código pode usar a mesma chave salva, sem fixar uma segunda cópia dela no código.

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

Use cache. Um transient indexado pelos dados de entrada transforma um crédito por visitante em um crédito por hora — e os blocos fazem exatamente isso 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);
}