Parede social 
Análise de feeds 
Como personalizar o código HTML do feed do YouTube com ficheiros de modelo PHP no seu tema, e as vantagens e desvantagens em termos de manutenção e suporte.
Gostaria de alterar o código HTML gerado pelo seu feed do YouTube, utilizando os seus próprios ficheiros de modelo?
Este guia explica como ativar modelos personalizados e adicionar um sby pasta para o seu tema e selecionar os ficheiros de modelo que pretende personalizar.
Antes de começar, certifique-se de que o YouTube Feed está instalado e ativado no seu site WordPress. Também precisa de um tema cujos ficheiros possa editar, de preferência um tema filho.
Eis o que vamos abordar:
- Antes de começar
- Ativar modelos personalizados
- Criação da pasta «sby»
- Escolher um ficheiro de modelo
- Copiar e editar um modelo
- Perguntas mais frequentes
Antes de começar
Os modelos personalizados substituem o código HTML do próprio plugin por ficheiros do seu tema. Isto permite-lhe alterar o código HTML gerado pelo seu feed.
No entanto, isso também implica algumas desvantagens. Os modelos personalizados podem necessitar de manutenção quando atualizar o plugin, uma vez que as suas cópias não são alteradas quando os ficheiros do plugin são atualizados. Além disso, podem limitar o nível de apoio que a Smash Balloon pode oferecer.
Se pretender apenas alterar cores, tamanhos ou o layout, utilize o editor de feeds. Os modelos personalizados destinam-se a alterações no próprio código HTML.
Se possível, coloca os teus modelos num tema filho. Uma atualização do tema pode sobrescrever os ficheiros que adicionares ao tema pai.
Ativar modelos personalizados
Para começar, vamos ativar a configuração que indica ao plugin para procurar ficheiros de modelo no seu tema.
Primeiro, aceda a «Feed do YouTube» » «Definições» no painel de controlo do WordPress e clique no separador «Avançado ».
Em seguida, ative a opção «Modelos personalizados».
Em seguida, clique em «Guardar alterações».
Esta configuração aplica-se a todos os feeds do seu site. O editor de feeds não dispõe de um botão «Modelos personalizados» específico para um único feed.
Por enquanto, nada muda na interface do utilizador, porque o plugin só utiliza um ficheiro de modelo quando encontra um no seu tema.
Criação da pasta «sby»
Em seguida, crie uma nova pasta com o nome sby na pasta do seu tema ativo. O plugin só procura os seus modelos numa pasta com este nome exato. Por exemplo:
wp-content/themes/your-child-theme/sby/Pode fazê-lo através do SFTP ou do gestor de ficheiros da sua conta de alojamento.
Se utilizar um tema filho, o plugin verifica-o primeiro. Se não encontrar o ficheiro nesse tema, verifica o tema pai.
Escolher um ficheiro de modelo
Agora, localize o ficheiro que controla a parte do feed que pretende alterar. O plugin só utiliza um ficheiro personalizado quando o seu nome corresponde ao desta tabela. O ficheiro também tem de estar localizado diretamente na sua sby pasta:
Apresente o seu sby pasta | O que controla |
|---|---|
feed.php | O contentor de feed que contém o cabeçalho, os vídeos, o leitor e o rodapé |
header.php | O cabeçalho do canal |
header-generic.php | O cabeçalho genérico que o plugin apresenta quando não existem detalhes do canal |
item.php | Cada vídeo no feed |
info.php | As informações apresentadas em cada vídeo. O plugin também utiliza este ficheiro para as informações apresentadas no leitor de vídeo |
player.php | O reprodutor de vídeo |
footer.php | A área abaixo do feed, com os botões «Carregar mais» e «Subscrever» |
cta.php | O apelo à ação |
shortcode-content.php | A saída do youtube-feed-single código abreviado |
form.php | O formulário de pesquisa de vídeos do youtube-feed-search código abreviado |
results.php | O elemento que envolve os resultados da pesquisa |
result.php | Cada resultado da pesquisa |
As próprias cópias do plugin de shortcode-content.php sentar-se num single pasta. As suas cópias de form.php, results.phpe result.php sentar-se num search pasta. No teu tema, coloca-os diretamente em sby, porque o plugin não procura nas subpastas de sby.
Alguns destes ficheiros só estão disponíveis na versão paga do plugin. Na versão gratuita do plugin, templates A pasta contém feed.php, header.php, header-generic.php, header-text.php, item.php, player.phpe footer.php. Os restantes ficheiros da tabela apenas alteram um feed num site que tenha o plugin pago instalado.
Copiar e editar um modelo
Em seguida, copie o ficheiro que escolheu da pasta do plugin templates pasta. Num site com o plugin pago, essa pasta é:
wp-content/plugins/youtube-feed-pro/templates/Com o plugin gratuito, a pasta é:
wp-content/plugins/feeds-for-youtube/templates/Cola o ficheiro na pasta do teu tema sby pasta e, em seguida, edite a cópia. Por exemplo, para alterar o código HTML de cada vídeo no feed, copie item.php para sby/item.php.
Começar a partir do próprio ficheiro do plugin permite manter tudo o que o feed já utiliza, pelo que só altera as partes necessárias.
Não é necessário adicionar ficheiros que não pretenda alterar. Para qualquer ficheiro que falte em sby, o plugin utiliza o seu próprio modelo.
E pronto! Agora já sabes como ativar modelos personalizados, adicionar um sby pasta para o seu tema e personalize o código HTML do plugin. Se, em vez disso, pretender alterar o comportamento do seu feed, o nosso guia de JavaScript personalizado é o próximo passo.
Perguntas mais frequentes
A seguir, respondemos a algumas das perguntas mais frequentes sobre modelos personalizados.
Tenho de copiar todos os ficheiros de modelo para o meu tema?
Não. Adicione apenas os ficheiros que pretende alterar. Para cada ficheiro que não esteja na sua sby pasta, o plugin utiliza o seu próprio modelo.
Ativei os «Modelos Personalizados», mas o meu feed continua a utilizar o HTML predefinido. Porquê?
Verifica primeiro estes aspetos. Os modelos personalizados têm de estar ativados e guardados em Feed do YouTube » Definições, no separador «Avançado». A pasta tem de se chamar sby e devem estar localizados no seu tema ativo ou no tema pai, caso utilize um tema filho. O nome do ficheiro deve corresponder exatamente ao da tabela acima. Os ficheiros que o plugin mantém num single ou search A pasta tem de ser colocada diretamente em sby. Se utilizar um plugin de cache, limpe o cache e atualize a página.
Posso personalizar o texto do cabeçalho?
Não. Quando o «Estilo do cabeçalho» de um feed está definido como «Texto», o plugin utiliza sempre o seu próprio header-text.php ficheiro. Não procura esse ficheiro no seu sby pasta.
Os meus modelos continuarão a funcionar depois de atualizar o plugin?
Os seus ficheiros permanecem no seu tema, pelo que uma atualização do plugin não os remove. Além disso, não incorporam as alterações do plugin. Após uma atualização, compare as suas cópias com os ficheiros atuais do plugin e aplique as alterações necessárias. Uma atualização do tema pode sobrescrever ficheiros na própria pasta do tema, razão pela qual recomendamos a utilização de um tema filho.
Posso ativar modelos personalizados através do código, em vez de utilizar a configuração?
Sim. O plugin transmite o valor da configuração através de um filtro chamado sby_use_theme_templates. O seu código pode devolver true para utilizar os modelos no seu tema. Isto é útil quando configura o seu site através do código e pretende ativar os modelos sem ter de aceder à página de Configurações.
