Certamente há muito que você precisa se lembrar quando trabalha com arquivos de tema do WordPress.
Dos nomes de arquivos de modelo básicos para funções e como o WordPress Loop funciona, é quase impossível lembrar de cada tag PHP ou mesmo como definir um novo tema.
Cerca de 550 alunos matriculados em nosso curso , WordPress Development for Beginners, estão em sua última semana, todos abordando a tarefa final – criando um tema do WordPress a partir do zero.
Então, para ajudá-lo, eu pensei que eu reuniria esta útil folha de truques, que inclui todos os arquivos e funções que você precisa saber (mas não necessariamente lembrar!) Ao trabalhar com temas. Este é definitivamente um para marcar e salvar para futuras referências!
Arquivos de Tema
Estes são os arquivos básicos que cada tema deve incluir:
style.css– Este é o arquivo de folha de estilo do seu tema.index.php– Este é o modelo do corpo principal para o seu tema. Seu trabalho é reunir todas as informações nos outros arquivos de tema usando tags de modelo.header.php– Este arquivo contém as informações de cabeçalho que aparecem com a<head>seção do seu site, coisas como metadados e o link para a sua folha de estilos.sidebar.php– Tudo em sua barra lateral vai neste arquivo, como widgets, categorias, menus adicionais, formulário de pesquisa, etc.footer.php– Este arquivo contém as informações do rodapé, como detalhes de direitos autorais, widgets e ícones sociais.single.php– Este arquivo exibe apenas uma publicação.page.php– Quando você cria uma página em seu site, este é o modelo responsável.comments.php– Este arquivo é responsável por exibir comentários.404.php– Quando os visitantes tentam visitar uma página no seu site que não existe, este arquivo será geral uma página de erro.functions.php– Este arquivo é onde você pode colocar funções especiais. Recomendamos sempre criar um tema infantil em vez de editar este arquivo diretamente .archive.php– Exibe um arquivo com este arquivo para que os visitantes do seu site possam retornar quando lê seu Hello World! postar.search.php– Ajude seus visitantes a pesquisar seu site com esta página.searchform.php– Exibe um formulário de pesquisa para seus visitantes com este arquivo de modelo.
Definindo um novo tema
Sua folha de estilo não contém apenas informações de estilo para o seu tema – também contém detalhes sobre o seu tema que são exibidos na seção Aparência> Temas do seu administrador do WordPress.
O seguinte é um exemplo das primeiras linhas da folha de estilos para o tema padrão Twenty Sixteen:
| / * | |
| Nome do tema: vinte e dezesseis | |
| URI do tema: https://wordpress.org/themes/twentysixteen/ | |
| Autor: a equipe do WordPress | |
| Autor URI: https://wordpress.org/ | |
| Descrição: Twenty Sixteen é uma visão moderna em um layout de WordPress sempre popular – o masthead horizontal com uma barra lateral direita opcional que funciona perfeitamente para blogs e sites. Possui opções de cores personalizadas com belos esquemas de cores padrão, uma grade de fluidos harmoniosa usando uma abordagem móvel primeiro e um polimento impecável em todos os detalhes. Twenty Sixteen fará com que seu WordPress pareça bonito em todos os lugares. | |
| Versão: 1.2 | |
| Licença: GNU General Public License v2 ou posterior | |
| URI da licença: http://www.gnu.org/licenses/gpl-2.0.html | |
| Tags: preto, azul, cinza, vermelho, branco, amarelo, escuro, leve, uma coluna, duas colunas, barra lateral direita, layout fixo, layout responsivo, pronto para acessibilidade, personalizado, cores personalizadas, Custom-header, custom-menu, editor-estilo, imagens em destaque, cabeçalho flexível, microformatos, pós-formatos, suporte a linguagem rtl, postagem pegajosa, comentários em linha, pronta para tradução | |
| Domínio do texto: twentysixteen | |
| Este tema, como o WordPress, está licenciado sob a GPL. | |
| Use-o para fazer algo legal, divirta-se e compartilhe o que aprendeu com os outros. | |
| * / |
Esta informação está no topo do seu arquivo stylesheet.css .
Modelo Incluir Tags
As tags de modelo incluem tags são usadas dentro de um arquivo de modelo (por exemplo, index.php) para incluir (ou chamar) o HTML e o PHP encontrados em outro arquivo de modelo (por exemplo, header.php). Embora o PHP tenha sua própria declaração incorporada () para fazer isso, essas tags específicas do WordPress tornam a vida muito mais fácil:
<?php get_header(); ?>– Inclui o arquivo header.php<?php get_sidebar(); ?>– Inclui o arquivo sidebar.php<?php get_footer(); ?>– Inclui o arquivo footer.php<?php comments_template(); ?>– Inclui seus comentários
Cabeçalho de modelo / Bloginfo Tags
Estas são funções que você encontrará no arquivo header.php do seu tema, embora você também os encontre em outros arquivos de tema:
<?php bloginfo('name'); ?>– O título do seu site, ou o nome do blog<?php bloginfo('url'); ?>– URL do seu site<?php bloginfo('stylesheet_url'); ?>– Link para o arquivo de estilos de estilos de seus temas<?php bloginfo('template_url'); ?>– Localização do arquivo do tema do seu site<?php bloginfo('description'); ?>– Exibe o slogan do seu blog conforme definido em Configurações> Geral .<?php bloginfo('atom_url'); ?>– Link para o URL do átomo do seu site<?php bloginfo('rss2_url'); ?>– URL de feed RSS para o seu site<?php bloginfo('pingback_url'); ?>– Pingback URL para o seu site<?php bloginfo('version'); ?>– Número da versão do WordPress<?php bloginfo('html_type'); ?>– A versão HTML que o seu site está usando<?php site_url(); ?>– O URL de raiz do seu site<?php get_stylesheet_directory(); ?>– Localização da sua pasta de folha de estilos<?php wp_title(); ?>– Título de uma página específica
Tags de modelo
Essas tags podem ser usadas em todos os seus arquivos de modelo, como index.php ou page.php, facilitando a exibição de informações específicas em qualquer lugar que desejar no seu site:
<?php the_content(); ?>– Exibe o conteúdo de uma postagem
<?php the_excerpt(); ?>– Exibe o excerto usado nas postagens
<?php the_title(); ?>– Título do post específico
<?php the_permalink() ?>– Link de uma publicação específica
<?php the_category(', ') ?>– Categoria de uma publicação específica
<?php the_author(); ?>– Autor de uma publicação específica
<?php the_ID(); ?>– identificação de uma publicação específica
<?php edit_post_link(); ?>– Editar link para uma publicação
<?php next_post_link(' %link ') ?>– URL da próxima página
<?php previous_post_link('%link') ?>– URL da página anterior
<?php get_links_list(); ?>– Lista todos os links em blogroll
<?php wp_list_pages(); ?>– Lista todas as páginas
<?php wp_get_archives() ?>– Listar arquivo para o site
<?php wp_list_cats(); ?>– Lista todas as categorias
<?php get_calendar(); ?>– Exibe o calendário interno – Exibe o
<?php wp_register(); ?>link do registro
<?php wp_loginout(); ?>– Exibe somente o logon / logout Para usuários registrados
Esta não é, de modo algum, uma lista definitiva de todas as tags de modelos disponíveis. Para a lista completa, confira a entrada de Tags do Modelo no WordPress Codex .
O Loop é o mecanismo padrão no WordPress para exibir todas as suas postagens. Exatamente o número de postagens obtidas é determinado pelo número de postagens que você escolheu para exibir nas configurações de “Leitura” em seu painel do WordPress.
Dentro do Loop, o WordPress percorre cada publicação recuperada para a página atual uma de cada vez e formata-a de acordo com as instruções do seu tema.
Você pode usar o Loop para fazer muitas coisas úteis, como:
- Exibir títulos e trechos de postagens na sua página inicial;
- Exibir o conteúdo e os comentários em uma única publicação;
- Exibir o conteúdo em uma página individual usando tags de modelo; e
- Exibir dados de tipos de postagem personalizados e campos personalizados.
| <? Php | |
| Se (have_posts ()): | |
| Enquanto (have_posts ()): | |
| The_post (); | |
| // | |
| // Postar conteúdo aqui | |
| // | |
| Falecido; // termina enquanto | |
| fim se; // fim se | |
| ?> |
O Loop pode exibir muitos elementos diferentes para cada publicação. Algumas das tags de modelo mais comuns usadas nos temas (de acordo com o Manual do Tema do WordPress) são:
next_post_link()– Um link para o post publicado cronologicamente após o post atualprevious_post_link()– Um link para o post publicado cronologicamente antes da publicação atualthe_category()– A categoria ou categorias associadas à publicação ou página a ser visualizadathe_author()– O autor da publicação ou da páginathe_content()– O conteúdo principal de uma publicação ou páginathe_excerpt()– As primeiras 55 palavras do conteúdo principal de um post seguido de reticências (…) ou leia mais links que vão para a publicação completa. Você também pode usar o campo “Excerto” de uma postagem para personalizar o comprimento de um trecho específico.the_ID()– O ID para a publicação ou a páginathe_meta()– Os campos personalizados associados à publicação ou páginathe_shortlink()– Um link para a página ou publicação usando o URL do site e a identificação da postagem ou da páginathe_tags()– A etiqueta ou as tags associadas à publicaçãothe_title()– O título da publicação ou da páginathe_time()– A hora ou a data da publicação ou da página. Isso pode ser personalizado usando a formatação padrão da função de data php.
Você também pode usar tags condicionais, tais como:
is_home()– Retorna verdadeiro se a página atual for a página inicialis_admin()– Retorna verdadeiro se um administrador estiver logado e visitando o siteis_single()– Retorna verdadeiro se a página estiver exibindo uma única publicaçãois_page()– Retorna verdadeiro se a página estiver exibindo uma única páginais_page_template()– Pode ser usado para determinar se uma página está usando um modelo específico, por exemplo:is_page_template('about-page.php')is_category()– Retorna verdadeiro se a página ou a postagem tiverem a categoria especificada, por exemplois_category('news')is_tag()– Retorna verdadeiro se uma página ou publicação tiver a etiqueta especificadais_author()– Retorna verdadeiro se um autor específico tiver logado e visitar o siteis_search()– Retorna verdadeiro se a página atual for uma página de resultados de pesquisais_404()– Retorna verdadeiro se a página atual não existirhas_excerpt()– Retorna verdadeiro se a publicação ou a página tiverem um excerto
