{"id":233953,"date":"2023-02-25T12:37:00","date_gmt":"2023-02-25T09:37:00","guid":{"rendered":"https:\/\/wordpress.mediadoma.com\/?p=233953"},"modified":"2022-11-11T13:22:54","modified_gmt":"2022-11-11T10:22:54","slug":"tutorial-de-tema-wordpress-para-iniciantes-parte-1-introducao","status":"publish","type":"post","link":"https:\/\/wordpress.mediadoma.com\/pt-pt\/tutorial-de-tema-wordpress-para-iniciantes-parte-1-introducao\/","title":{"rendered":"Tutorial de Tema WordPress para Iniciantes &#8211; Parte 1: Introdu\u00e7\u00e3o"},"content":{"rendered":"\n<p>Nesta li\u00e7\u00e3o, voc\u00ea come\u00e7ar\u00e1 a aprender como o WordPress carrega conte\u00fado dependendo da p\u00e1gina em que voc\u00ea est\u00e1 e da hierarquia dos arquivos de modelo de tema. Voc\u00ea tamb\u00e9m aprender\u00e1 o que \u00e9 necess\u00e1rio para um tema v\u00e1lido. E no final vamos finalmente criar nosso tema e ativ\u00e1-lo.<\/p>\n<h2>Arquivos de modelo de tema<\/h2>\n<p>Por tr\u00e1s do cap\u00f4, o WordPress descobre qual modelo carregar com base na URL em que voc\u00ea est\u00e1. Se o seu WordPress estiver instalado no dom\u00ednio &#8220;example.com\/wordpress\/&quot;, voc\u00ea dever\u00e1 ver o modelo da p\u00e1gina inicial. Ir para &#8220;example.com\/wordpress\/category\/news\/&quot; como padr\u00e3o fornecer\u00e1 uma lista de postagens atribu\u00eddas \u00e0 categoria Not\u00edcias usando um modelo de categoria.<\/p>\n<p>O WordPress segue uma hierarquia de qual template carregar, e qual ele escolhe depende de quais templates voc\u00ea tem dispon\u00edveis em seu tema. Por exemplo, &#8220;example.com\/wordpress\/category\/news&#8221; o WordPress primeiro procurar\u00e1 um modelo espec\u00edfico para a categoria &#8220;news&#8221;. Se n\u00e3o for encontrado, o WordPress procurar\u00e1 um modelo espec\u00edfico para o ID da categoria. Novamente, se isso n\u00e3o for encontrado, o WordPress procura o modelo de categoria geral. Se isso n\u00e3o for encontrado, o WordPress procurar\u00e1 um modelo ainda mais geral para arquivos. E assim por diante.<\/p>\n<p>O WordPress Codex, que \u00e9 o site de documenta\u00e7\u00e3o do WordPress, mant\u00e9m uma imagem \u00fatil e atualizada que ilustra a hierarquia dos arquivos de templates de temas; <a href=\"https:\/\/codex.wordpress.org\/File:Template_Hierarchy.png#file\" target=\"_blank\" rel=\"noopener nofollow\" class=\"external external_icon\">https:\/\/codex.wordpress.org\/File:Template_Hierarchy.png#file<\/a><\/p>\n<p>N\u00e3o se preocupe se a imagem parecer muito confusa no come\u00e7o! \u00c0 medida que avan\u00e7amos no tutorial, voc\u00ea se ver\u00e1 consultando esta imagem para descobrir quais modelos voc\u00ea deseja implementar em seu tema.<\/p>\n<p>A maneira como voc\u00ea l\u00ea a imagem \u00e9 indo da esquerda para a direita. Com base em qual p\u00e1gina voc\u00ea est\u00e1, os modelos s\u00e3o muito espec\u00edficos, e quanto mais voc\u00ea avan\u00e7a para o lado direito, mais gerais os modelos se tornam. O fallback final \u00e9 o mais \u00e0 direita; <code>index.php<\/code>, que ser\u00e1 carregado se nenhum outro modelo de ajuste for encontrado.<\/p>\n<p>Todos os arquivos de modelo listados na imagem acima precisam residir na pasta raiz do seu tema e ser nomeados exatamente como indicado. Voc\u00ea n\u00e3o pode colocar seus modelos em subpastas para fins organizacionais porque o WordPress n\u00e3o poder\u00e1 encontr\u00e1-los!<\/p>\n<p>Vamos come\u00e7ar simples! Hoje vamos criar os poucos arquivos necess\u00e1rios para o WordPress reconhec\u00ea-lo como um tema e depois expandir a partir da\u00ed.<\/p>\n<h2>Anatomia de um tema WordPress<\/h2>\n<p>Voc\u00ea precisa de apenas dois arquivos para criar um tema WordPress v\u00e1lido.<\/p>\n<p>Na ilustra\u00e7\u00e3o da hierarquia de modelos, voc\u00ea notou o mais \u00e0 direita; chamado <code>index.php<\/code>? Este \u00e9 o modelo de fallback final se o WordPress n\u00e3o encontrar nenhum modelo. Esse \u00e9 um dos arquivos necess\u00e1rios. O outro arquivo \u00e9 um arquivo de folha de estilo (<code>.css<\/code>). Ele n\u00e3o precisa necessariamente ter CSS, mas precisa conter um bloco de coment\u00e1rios que forne\u00e7a informa\u00e7\u00f5es ao WordPress sobre seu tema. Essas duas coisas s\u00e3o tudo o que voc\u00ea precisa para um tema WordPress v\u00e1lido.<\/p>\n<p>Vamos criar nosso tema criando esses dois arquivos!<\/p>\n<h2>Criando seu primeiro tema<\/h2>\n<p>Todos os temas precisam estar em suas pastas separadas dentro da subpasta <code>\/wp-content\/themes\/<\/code>. Se voc\u00ea navegar para esta pasta em seu navegador de arquivos, provavelmente j\u00e1 ver\u00e1 algumas pastas de temas aqui; Twentynineteen, Twentyseventeen, etc. Esses s\u00e3o temas que v\u00eam inclu\u00eddos no WordPress como padr\u00e3o.<\/p>\n<p>Em <code>\/wp-content\/themes\/<\/code>, crie uma nova pasta. Nomeie-o adequadamente (min\u00fasculas, sem espa\u00e7os, n\u00e3o igual a qualquer outra pasta). Normalmente, o nome da pasta \u00e9 uma vers\u00e3o slug do nome do seu tema. Para este tutorial, vou nomear minha pasta de tema &#8221; <code>wptutorial<\/code>&#8220;.<\/p>\n<p><a href=\"https:\/\/wordpress.mediadoma.com\/wp-content\/uploads\/2022\/01\/post-151676-61e4cdc958a13.png\" data-rel=\"lightbox\"><img decoding=\"async\" class=\"SDStudio-light-box-enable SDStudio-editor-tools-md-imp\" src=\"https:\/\/wordpress.mediadoma.com\/wp-content\/uploads\/2022\/01\/post-151676-61e4cdc958a13.png\" alt=\"Tutorial de Tema WordPress para Iniciantes - Parte 1: Introdu\u00e7\u00e3o\" ><\/a><\/p>\n<p>Entre na pasta do seu tema e crie um novo arquivo vazio chamado <code>index.php<\/code>. Editei o arquivo e apenas adicionei algum texto aleat\u00f3rio, para que possamos ver mais facilmente quando estiver em uso:<\/p>\n<p><a href=\"https:\/\/wordpress.mediadoma.com\/wp-content\/uploads\/2022\/01\/post-151676-61e4cdca20059.png\" data-rel=\"lightbox\"><img decoding=\"async\" class=\"SDStudio-light-box-enable SDStudio-editor-tools-md-imp\" src=\"https:\/\/wordpress.mediadoma.com\/wp-content\/uploads\/2022\/01\/post-151676-61e4cdca20059.png\" alt=\"Tutorial de Tema WordPress para Iniciantes - Parte 1: Introdu\u00e7\u00e3o\" ><\/a><\/p>\n<p>J\u00e1 estamos na metade! Vamos criar o segundo arquivo necess\u00e1rio. Dentro da pasta do seu tema, crie um novo arquivo vazio chamado <code>style.css<\/code>.<\/p>\n<p>Abra o <code>style.css<\/code>arquivo e inicie imediatamente um bloco de coment\u00e1rios (<code>\/*<\/code>e feche-o com <code>*\/<\/code>). Dentro deste bloco de coment\u00e1rios, precisamos seguir algumas regras do WordPress em como definir nosso tema. No m\u00ednimo, precisamos definir o nome do nosso tema. Mas tamb\u00e9m podemos adicionar informa\u00e7\u00f5es sobre quem \u00e9 o autor, p\u00e1gina inicial, n\u00famero da vers\u00e3o, informa\u00e7\u00f5es de licen\u00e7a e muito mais. Veja <a href=\"https:\/\/codex.wordpress.org\/Theme_Development#Theme_Stylesheet\" target=\"_blank\" rel=\"noopener nofollow\" class=\"external external_icon\">a documenta\u00e7\u00e3o do WordPress sobre o que voc\u00ea pode adicionar<\/a>.<\/p>\n<p>Neste tutorial vamos mant\u00ea-lo simples; adicionaremos o nome do tema e voc\u00ea escrever\u00e1 seu pr\u00f3prio nome como autor. Voc\u00ea pode ir em frente e usar o(s) nome(s) que quiser, isso \u00e9 o que eu inseri no meu <code>style.css<\/code>:<\/p>\n<pre><code>\/* \nTheme Name: A White Pixel Theme \nAuthor: Alex White \n*\/<\/code><\/pre>\n<p>Salve e feche o arquivo (este tutorial n\u00e3o tocar\u00e1 neste arquivo novamente), a menos que voc\u00ea queira escrever CSS para o seu tema \u00e0 medida que avan\u00e7a.<\/p>\n<p>Parab\u00e9ns! Voc\u00ea acabou de criar um tema WordPress v\u00e1lido!<\/p>\n<h2>Ativando seu tema<\/h2>\n<p>Vamos entrar no painel de administra\u00e7\u00e3o do WordPress e navegar at\u00e9 &#8220;Apar\u00eancia &gt; Temas&#8221; e ver se podemos encontrar nosso tema l\u00e1.<\/p>\n<p><a href=\"https:\/\/wordpress.mediadoma.com\/wp-content\/uploads\/2022\/01\/post-151676-61e4cdcb3024b.gif\" data-rel=\"lightbox\"><img decoding=\"async\" class=\"SDStudio-light-box-enable SDStudio-editor-tools-md-imp\" src=\"https:\/\/wordpress.mediadoma.com\/wp-content\/uploads\/2022\/01\/post-151676-61e4cdcb3024b.gif\" alt=\"Tutorial de Tema WordPress para Iniciantes - Parte 1: Introdu\u00e7\u00e3o\" ><\/a><\/p>\n<p>Clique no bot\u00e3o Ativar e visite seu site. Voc\u00ea deve ver o que voc\u00ea escreveu <code>index.php<\/code>!<\/p>\n<p>Este <code>index.php<\/code>modelo ser\u00e1 usado independentemente da p\u00e1gina em que voc\u00ea estiver. Tente ver um \u00fanico post, e voc\u00ea ver\u00e1 o mesmo. Um tema deve ter no m\u00ednimo 5-10 modelos para lidar com diferentes conte\u00fados. N\u00e3o se preocupe, n\u00f3s chegaremos l\u00e1.<\/p>\n<p>Incr\u00edvel, temos um tema! Na pr\u00f3xima li\u00e7\u00e3o, come\u00e7aremos a codificar e fazer coisas.<\/p>\n<p><div id=\"PostUnique_PostSource\" style=\"padding-top: 50px\">Fonte de grava\u00e7\u00e3o:  <a target=\"_blank\" rel=\"noopener nofollow\" href=\"\/\/awhitepixel.com\" class=\"external external_icon\">awhitepixel.com<\/a><\/div><\/p>\n","protected":false},"excerpt":{"rendered":"<p>Nesta li\u00e7\u00e3o, aprendemos o b\u00e1sico de como um tema WordPress carrega conte\u00fado, o que \u00e9 necess\u00e1rio para um tema v\u00e1lido &#8211; e criaremos nosso primeiro tema!<\/p>\n","protected":false},"author":1,"featured_media":223984,"comment_status":"closed","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"footnotes":"","_wp_rev_ctl_limit":""},"categories":[930,898,898,722,722,837,920,1110,920,837,930,846,846,867,867],"tags":[1170],"class_list":["post-233953","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-assuntos","category-codigo-2","category-desenvolvedor","category-guia-para-iniciantes","category-outro","category-n-a","category-tutoriais","category-wordpress-8","tag-affiai-pt-pt"],"_links":{"self":[{"href":"https:\/\/wordpress.mediadoma.com\/pt-pt\/wp-json\/wp\/v2\/posts\/233953","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/wordpress.mediadoma.com\/pt-pt\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/wordpress.mediadoma.com\/pt-pt\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/wordpress.mediadoma.com\/pt-pt\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/wordpress.mediadoma.com\/pt-pt\/wp-json\/wp\/v2\/comments?post=233953"}],"version-history":[{"count":0,"href":"https:\/\/wordpress.mediadoma.com\/pt-pt\/wp-json\/wp\/v2\/posts\/233953\/revisions"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/wordpress.mediadoma.com\/pt-pt\/wp-json\/wp\/v2\/media\/223984"}],"wp:attachment":[{"href":"https:\/\/wordpress.mediadoma.com\/pt-pt\/wp-json\/wp\/v2\/media?parent=233953"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/wordpress.mediadoma.com\/pt-pt\/wp-json\/wp\/v2\/categories?post=233953"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/wordpress.mediadoma.com\/pt-pt\/wp-json\/wp\/v2\/tags?post=233953"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}