OpenByt - A sua melhor fonte de conhecimento gratuito sobre WordPress

Simplificando o desenvolvimento do WordPress: Crie o seu próprio repositório de snippets de código

f Lin

As a WordPress developer, you’ve likely solved the same problems repeatedly—adding custom post types, tweaking theme functions, or adjusting plugin behaviour. Imagine this scenario: you’re working on a client project and must add a specific function that customizes the login page. You remember doing something similar before but can’t recall where you saved that snippet. You spend valuable time searching through old projects or browsing online resources, only to rewrite them from scratch. This kind of repetitive work is frustrating and inefficient. The solution? Build your code snippet repository. Creating a personal library of reusable code snippets can save you valuable time, reduce redundancy, and make your development process more efficient and organized. A well-maintained repository can be a lifesaver, making frequently used code easily accessible and reducing development time.

Porque precisa de um repositório de fragmentos de código

Imagine que está a trabalhar em vários sites WordPress. Para cada projeto, precisa de adicionar uma função específica que modifica a página de início de sessão. Em vez de procurar no Stack Overflow ou navegar pelos seus projectos anteriores para encontrar esse snippet, ter um repositório centralizado significa que pode facilmente obter o código e implementá-lo em minutos.

Um repositório de fragmentos de código ajuda-o:

Configurar o seu próprio repositório de snippets de código

Existem várias formas de organizar a sua biblioteca de fragmentos de código, desde ferramentas simples como editores de texto a soluções mais robustas como o GitHub ou mesmo plug-ins dedicados do WordPress. Vamos analisar alguns métodos populares passo a passo:

1: Utilizar uma aplicação de notas baseada na nuvem

A forma mais simples de começar a criar uma biblioteca de fragmentos de código é utilizar aplicações de anotações baseadas na nuvem. Isto é perfeito para principiantes ou para aqueles que preferem uma abordagem leve para gerir o seu código.

Muitos programadores utilizam ferramentas como Noção, Evernote, ou Google Keep para gerir as suas bibliotecas de fragmentos de código. Cada ferramenta tem os seus prós e contras:

Trecho de código:

function custom_login_redirect($redirect_to, $request, $user) {
    // Redirecionar os utilizadores para a página inicial após o início de sessão
    devolva home_url();
}
add_filter('login_redirect', 'custom_login_redirect', 10, 3);

Com a utilização de aplicações na nuvem, pode aceder aos seus snippets a partir de qualquer lugar, o que o torna ideal se trabalhar em vários dispositivos.

2. Controlo de versões com o GitHub ou o GitLab

Para uma abordagem mais avançada, considere armazenar os seus snippets em GitHub ou GitLab. If you’re new to version control, start by creating a GitHub account, installing Git on your computer, and learning basic Git commands like git init (para inicializar um repositório), git add (para adicionar ficheiros à fase de preparação), git commit (para guardar as alterações), e git push (to upload your changes to GitHub). Additionally, familiarize yourself with branching, which allows you to safely experiment with changes. This setup not only gives you a safe backup but also lets you track changes over time—useful when you’re iterating on your code. If you’re new to version control, start by creating a GitHub account, installing Git on your computer, and learning basic Git commands like git init (para inicializar um repositório), git add (para adicionar ficheiros à fase de preparação), git commit (para guardar as alterações), e git push (para carregar as suas alterações no GitHub). Esta configuração não só lhe dá uma cópia de segurança segura, como também lhe permite acompanhar as alterações ao longo do tempo - útil quando está a iterar no seu código. Esta configuração não só lhe dá uma cópia de segurança segura, como também lhe permite acompanhar as alterações ao longo do tempo - útil quando está a iterar no seu código.

Por exemplo, pode criar um repositório chamado wordpress-snippets e organize-o em diferentes pastas:

Uma pasta típica pode ter o seguinte aspeto:

wordpress-snippets/
  |-- theme-functions/
       |-- enqueue-scripts.php
       |-- custom-footer.php
  |-- shortcodes/
       |-- youtube-embed.php
  |-- admin-customization/
       |-- custom-dashboard-widget.php

With Git, you can collaborate with other developers and create a shared snippet library, making standardizing your team’s development approach easier. Remember to secure your repository by setting appropriate access controls and regularly backing it up to avoid any data loss. Using features like branch protection can prevent unauthorized changes and help maintain the quality of your code repository.

3. Plugins de gestão de snippets do WordPress

Existem também plugins como Trechos de código ou WPCodeBox que lhe permitem guardar, gerir e executar os seus snippets diretamente no painel de administração do WordPress. Isto significa que pode ativar ou desativar snippets sem ter de tocar no ficheiro functions.php do seu tema, e os snippets mantêm-se mesmo que mude de tema.

Por exemplo, se adiciona frequentemente um comprimento de excerto personalizado às suas publicações, pode adicioná-lo ao plug-in Code Snippets:

função custom_excerpt_length($length) {
    return 20; // Defina o comprimento do excerto para 20 palavras
}
add_filter('excerpt_length', 'custom_excerpt_length');
function custom_excerpt_length($length) {
    return 20; // Defina o comprimento do excerto para 20 palavras
}
add_filter('excerpt_length', 'custom_excerpt_length');

Com o plugin Code Snippets, pode rotular este snippet como "Comprimento do excerto personalizado" e active ou desactive-o conforme necessário.

Práticas recomendadas para o seu repositório de snippets de código

Uma armadilha comum é ter um repositório desorganizado. Imagine ter vários snippets com o nome snippet1.php ou código de teste. php-esses nomes não fornecem contexto, tornando difícil saber o que cada snippet faz sem abrir e ler o código. Por exemplo, um snippet mal nomeado como function-test.php poderia ser substituído por um nome descritivo como redirecionar-login personalizado.php, fornecendo instantaneamente o contexto. Por exemplo, trechos com nomes como snippet1.php ou código de teste.php não fornecem informações sobre o seu objetivo, tornando-os difíceis de reutilizar. Em vez disso, siga estas práticas recomendadas para garantir que os seus snippets são fáceis de encontrar e compreender:

Once you’ve set up your repository, following some best practices will help keep it organized and useful:

1.Utilize títulos descritivos: Titles like “Custom Post Type for Portfolio” or “Redirect After Login” make it easy to understand what each snippet does quickly.

2.Adicione comentários: Escreva uma breve descrição no início de cada snippet para explicar o que ele faz e como usá-lo. Por exemplo:

// Redirecionar os utilizadores para a página inicial depois de iniciarem sessão
function custom_login_redirect($redirect_to, $request, $user) {
    devolva home_url();
}

3.Organize por categoria: Categorize os snippets em pastas ou etiquetas com base na sua finalidade (por exemplo, admin, frontend, campos personalizados).

4.Teste regularmente: As actualizações do WordPress podem, por vezes, quebrar snippets antigos. Crie o hábito de testar periodicamente os seus snippets para garantir que continuam a funcionar como esperado.

Exemplo: Criando um snippet de tipo de post personalizado

Vamos utilizar um exemplo prático de construção de um snippet para um Tipo de post personalizado. Este é um requisito comum para sites WordPress que precisam de mais tipos de conteúdo além de Posts e Páginas. Aqui está o snippet:

função create_portfolio_post_type() {
    $args = array(
        'public' => true,
        'label' => 'Portfolio',
        'supports' => array('title', 'editor', 'thumbnail')
    );
    register_post_type('portfolio', $args);
}
add_action('init', 'create_portfolio_post_type');

By saving this snippet in your repository under a folder named custom-post-types/, you have it ready whenever needed. So, you’ll be prepared the next time a client wants a portfolio section on their website.

Conclusão

Building your code snippet repository may take some initial effort, but it’s an investment that will pay off in the long run. For beginners, tools like cloud-based note apps or WordPress plugins are great starting points due to their simplicity and ease of access. As you gain experience, consider transitioning to GitHub or GitLab for more control, collaboration features, and version history tracking. Each method has its advantages—cloud tools are simple and accessible, plugins integrate directly into WordPress, and version control tools provide safety, version tracking, and collaboration options. A plugin or cloud notes may be sufficient for small projects or beginners, but for larger teams or more complex needs, Git repositories are ideal. Choose a method that fits your workflow and start compiling your snippets today. For beginners, tools like cloud-based note apps or WordPress plugins are great starting points due to their simplicity. As you gain experience, consider transitioning to GitHub or GitLab for more control and collaboration features. Each method has advantages—cloud tools are simple and accessible, plugins integrate directly into WordPress, and version control tools provide safety and collaboration options. Choose a method that fits your workflow and start compiling your snippets today. With a well-organized library, you’ll write less code, reduce bugs, and complete projects faster. Whether you prefer cloud notes, Git repositories, or WordPress plugins, choose a method that fits your workflow and start compiling your snippets today.

Sair da versão móvel