Radha Core — Classic Theme

Descrição

O Radha Core é um tema WordPress clássico e minimalista, desenvolvido sob medida para hotéis boutique e pousadas que buscam excelência, acolhimento do hóspede e autonomia digital. Projetado para ser o núcleo de um ecossistema de alta performance, este tema integra-se nativamente ao plugin WP Hotel Booking, oferecendo uma experiência de reserva direta, fluida e livre de intermediários.

Arquitetura e Funcionalidades

O functions.php é o guardião do sistema, organizado em módulos de silêncio e precisão:

1. Suporte e Identidade

Native Support: Inclui suporte a title-tag, post-thumbnails, logotipos e cabeçalhos personalizados.
Localization: Preparado para traduções (text domain radha-core).
Menus: Regista áreas para o Menu Principal e Menu de Rodapé.

2. Soberania de Reservas (Correção do Plugin)

Hook Fix: Implementa uma correção crítica para o plugin WP Hotel Booking, que registava o formulário de reserva individual duplicado. O Radha Core remove os callbacks duplicados e regista um único, garantindo a integridade dos dados do hóspede e o funcionamento correto do AJAX.

3. Conteúdo Personalizado (CPT)

Promoções: Regista um Custom Post Type (radha_promo) para gerir ofertas especiais, com suporte a título, editor, miniatura e excerto, e habilitado para a REST API.

4. Performance e Limpeza (Head Clean)

Minimalismo: Remove lixo desnecessário do wp_head (versão do WP, RSD, WLW, oEmbed, emojis, etc.) para otimizar o tempo de carregamento e reforçar a segurança por obscuridade. Dashicons são desativados para visitantes não logados.

5. Gestão Inteligente de Assets

Carregamento Condicional: Os estilos e scripts são carregados apenas onde são necessários, evitando inchaço (bloat) em páginas que não os utilizam.
- header.css: Estrutural, carregado globalmente.
- home.css / content.css / wphb.css: Carregados condicionalmente com base na página atual (home, posts/páginas, ou páginas do plugin de reservas).
Versionamento: Utiliza um sistema de versão unificado ($v = '1.1.9') para invalidar a cache do navegador a cada atualização.
Localização de Scripts: Passa variáveis PHP para o JavaScript (header.js) para controlar o comportamento sticky do header e da barra de reservas.

6. Integração e Overrides do WP Hotel Booking

Template Aliases: Corrige erros de digitação nos nomes de ficheiros de template solicitados pelo plugin (ex: quanity.php para quantity.php), prevenindo erros e permitindo que o tema sobreponha os ficheiros corretamente.
Fuzzy Search: Implementa um sistema de busca de templates “fuzzy” como rede de segurança, garantindo que o template correto seja carregado mesmo que haja pequenas discrepâncias de nomenclatura no plugin original.

7. Ecossistema de Shortcodes

Busca de Alta Performance: Shortcode Data de Check-in Data de Check-out Adultos Crianças Número de quartos (e Data de Check-in Data de Check-out Adultos Crianças Número de quartos) customizado para renderizar o formulário de busca do template V2 do tema.
Mini Carrinho: Shortcode Carrinho pronto. para exibição leve do estado do carrinho.
Redes Sociais: Shortcode que gera dinamicamente a lista de ícones sociais configurados no Customizador.

8. Helpers e Utilitários

WhatsApp Direct: Função radha_get_whatsapp_url() que gera um link seguro para o WhatsApp com mensagem pré-definida (nome do site ou mensagem personalizada).
Contact Helpers: Função radha_get_contact() para acesso rápido e seguro aos dados do Customizador.

9. Estabilidade e Manutenção

Error Handler: Regista um manipulador de erros personalizado para suprimir warnings específicos do plugin WP Hotel Booking (strtoupper()), mantendo o front-end limpo e profissional.
Force Home Template: Garante que a index.php seja usada como template da Front Page, mesmo que o WordPress esteja configurado para usar uma página estática, preservando a estrutura dos blocos do Customizador na home.

10. Painel de Administração — Radha Core Settings

Settings Panel: Adiciona uma área de administração exclusiva (“Radha Core”) no menu principal.
Gestão Centralizada: Permite ao hoteleiro configurar dados de contacto, links de redes sociais e IDs de rastreamento (GA4, Meta Pixel) num único local, utilizando a API de theme_mod do WordPress para consistência com o Customizador.

11. Integração com IA (Chatbot)

NCB Integration: Se o plugin Chatbot AI Free Models estiver ativo, o tema inclui o ficheiro /inc/chatbot-wphb-integration.php para injetar contexto de acomodações e preços no system prompt do bot, tornando-o um assistente de reservas inteligente.

Instalação

Coloque a pasta radha-core na diretoria /wp-content/themes/.
Na área de administração do WordPress, vá a Aparência > Temas e ative o Radha Core.
Certifique-se de que o plugin WP Hotel Booking está instalado e configurado.
As configurações globais do tema encontram-se no menu “Radha Core”. As configurações visuais (cores, logo) estão no “Customizador”.

Notas de Desenvolvimento

Este tema foi concebido para ser um framework estável. Não edite os ficheiros do núcleo do tema. Utilize um Child Theme se necessitar de estender a funcionalidade, ou sobreponha os templates do plugin criando a pasta wp-hotel-booking na raiz do tema principal.