Como adicionar o widget de reservas Schedito ao Joomla
O Schedito pode ser adicionado ao Joomla sem uma extensão de reservas dedicada. Carregue a folha de estilos e o JavaScript partilhados do Schedito uma vez através da camada de recursos frontend do website e, depois, coloque o DIV específico do calendário onde os clientes devem poder reservar.
Para a própria posição de reservas, o módulo Custom do núcleo do Joomla fornece uma solução prática e fácil de gerir pelo administrador. Os recursos frontend partilhados devem normalmente ser tratados separadamente pelo template ativo ou pelo Web Asset Manager do Joomla.
Antes de abrir o Joomla
Um calendário Schedito configurado
Configure os serviços, recursos e disponibilidade que os clientes devem poder reservar antes de publicar o widget.
Acesso de administrador ao Joomla
Precisa de permissão para criar um Site Module e de acesso à configuração do template ou dos recursos frontend do website para os ficheiros partilhados do Schedito.
Os três elementos Schedito
Abra o código do widget no Schedito e mantenha a ligação CSS, o script JavaScript e o DIV do widget específico do calendário prontos para copiar.
1. Mantenha os três elementos da integração separados
O painel Schedito fornece três partes de código frontend:
Ligação CSS — fornece os estilos do widget de reservas.
Script JavaScript — inicializa e executa os widgets Schedito.
DIV do widget — identifica a organização e o calendário público de reservas e define onde o calendário deve aparecer.
No Joomla, os dois primeiros pertencem ao nível dos recursos do website ou do template. O DIV específico do calendário pertence à posição frontend onde os clientes devem ver a interface de reservas.
Ligação CSS — uma vez
JavaScript — uma vez
DIV do widget específico do calendário
2. Carregue o CSS e o JavaScript do Schedito uma vez
Nem todos os templates Joomla disponibilizam a mesma interface para código personalizado, pelo que não existe um único caminho no menu de administração aplicável a todos os websites Joomla.
Se o seu template ou framework de template ativo disponibilizar campos para código personalizado de Head, CSS ou JavaScript, utilize essas definições ao nível do website e adicione a ligação CSS e o script JavaScript atuais mostrados pelo Schedito.
Para uma integração nativa do Joomla por um programador, utilize o Web Asset Manager do Joomla a partir de um child template ou de uma pequena extensão do website para registar e ativar a folha de estilos e o script do Schedito.
Independentemente do método utilizado pelo seu website, carregue os recursos partilhados uma vez. Não coloque outra cópia em cada módulo de reservas.
Escolha o caminho que corresponde ao seu website
O template suporta código personalizado
Utilize as definições de Head / JavaScript ao nível do website.
Website Joomla personalizado ou mantido profissionalmente
Registe os recursos através do Joomla Web Asset Manager.
Evite
Editar ficheiros do núcleo do Joomla ou copiar CSS e JavaScript para cada módulo de reservas.
Para programadores: utilize o Web Asset Manager do Joomla
O Joomla moderno disponibiliza o Web Asset Manager especificamente para registar e carregar CSS e JavaScript de forma gerida. Pode tratar do registo de recursos, dependências, atributos e apresentação através do documento.
Um programador pode registar o URL da folha de estilos e o URL do script do painel Schedito atual através do child template do website ou de uma pequena extensão e ativá-los nas páginas frontend necessárias.
Isto é preferível a alterar ficheiros do núcleo do Joomla. Se o seu website utilizar um framework de template comercial com a sua própria interface suportada para código personalizado, esse mecanismo pode ser utilizado em alternativa.
3. Adicione o calendário através de um módulo Custom do Joomla
Abra System → Site Modules, crie um novo módulo e selecione o tipo de módulo Custom.
No painel Schedito, copie apenas o DIV do widget específico do calendário e coloque-o no conteúdo do módulo.
O DIV contém valores como data-organization-id e data-calendar-public-id. Utilize os valores exatos gerados para o calendário que pretende apresentar.
Dê ao módulo um título interno útil, oculte o título visível se for adequado e escolha a posição do template onde as reservas devem aparecer.
4. Escolha a posição do módulo e as páginas
Os módulos Joomla são apresentados através das posições disponibilizadas pelo template ativo do website. Selecione uma posição que coloque a interface de reservas onde ela faz sentido no seu layout.
Utilize as definições de Menu Assignment do módulo para decidir onde deve aparecer. Pode mostrá-lo em todas as páginas, apenas em itens de menu selecionados ou numa página dedicada a reservas, conforme a estrutura do seu Joomla.
Se a posição for demasiado estreita para uma interface de reservas, utilize outra posição do template ou ajuste o layout da página, em vez de forçar o calendário para um contentor com dimensão de barra lateral.
Exemplo
DIV do calendário Schedito
Conteúdo principal / posição adequada de largura total
Página Reservar agora
Certifique-se de que o editor Joomla preserva a marcação do widget
O módulo Custom do Joomla utiliza o editor de conteúdos configurado. Dependendo das definições, um editor pode modificar ou remover partes da marcação personalizada quando o módulo é guardado.
Depois de guardar, volte a abrir a vista HTML/código-fonte do módulo e confirme que os atributos class e data-* do Schedito continuam presentes.
Se o editor alterar a marcação, utilize o modo de código-fonte ou um fluxo de trabalho adequado com No Editor ao inserir o widget. Não volte a colar repetidamente marcação alterada sem verificar o que o Joomla guardou.
Utilizar vários calendários Schedito no Joomla
Mantenha a folha de estilos e o JavaScript partilhados do Schedito carregados uma vez através da camada de recursos do website ou do template.
Crie um módulo Custom separado para cada calendário ou local de reservas, utilizando em cada módulo o DIV específico do calendário correto.
As posições de módulos e o Menu Assignment do Joomla permitem depois decidir qual calendário aparece em que páginas sem duplicar os recursos frontend partilhados.
Partilhado uma vez
JavaScript do Schedito
Módulos separados
Módulo B → DIV do calendário B
Módulo C → DIV do calendário C
5. Publique e teste o fluxo completo de reservas
Verifique mais do que a posição do módulo: confirme o carregamento dos recursos, a disponibilidade e uma reserva real a partir do frontend Joomla.
Abra a página pública
Teste o frontend Joomla real e confirme que a folha de estilos, o JavaScript e o módulo do calendário se combinam numa interface de reservas funcional.
Conclua uma reserva
Selecione um serviço, data e hora e conclua uma reserva de teste real. Verifique a reserva resultante no Schedito.
Verifique o layout responsivo
Verifique a posição do módulo no computador e em dispositivos móveis e certifique-se de que o template Joomla ativo fornece ao widget largura útil suficiente.
Resolução de problemas do widget de reservas Joomla
Verifique de forma independente as três partes da integração. Confirme que a folha de estilos e o JavaScript partilhados do Schedito estão carregados na página pública e que o módulo continua a conter o DIV correto do calendário.
Depois, consulte as ferramentas de programador do navegador para detetar pedidos de recursos ou API com falha e erros de JavaScript.
O editor configurado pode estar a limpar ou reescrever a marcação. Abra o módulo em modo de código-fonte e compare o HTML guardado com o DIV fornecido pelo Schedito.
Se necessário, utilize um fluxo de trabalho adequado com No Editor ao inserir a marcação.
Verifique se o módulo está publicado, utiliza uma posição válida do template ativo e está atribuído ao item de menu correto.
Verifique também o nível de acesso e a atribuição de idioma se o website Joomla utilizar conteúdo multilingue ou restrito.
A integração Joomla provavelmente está a funcionar. Verifique antes o Schedito: serviço, recursos necessários, disponibilidade recorrente, exceções específicas por data, reservas existentes, capacidade e calendários externos ligados.
Verifique o template ativo, o framework do template e quaisquer módulos ou extensões personalizados utilizados para código frontend. Mantenha uma única integração ao nível do website e remova inclusões duplicadas de recursos.
Verifique a posição do módulo e o layout do template em redor. Posições de barra lateral, módulos de largura fixa, colunas de grelha, padding e regras de overflow podem limitar o widget mesmo quando o próprio Schedito é responsivo.
Mantenha o Joomla focado no conteúdo e o Schedito focado nas reservas
Quando a integração estiver a funcionar, continue a gerir serviços, recursos, disponibilidade, capacidade, sincronização de calendários e estilo do widget no Schedito.
Começar grátisVisão geral das reservas no Joomla
Explorar todos os guias Schedito · Personalização do widget · Sincronização com o Google Calendar