Padrões de Desenvolvimento, vamos discutir?
Precisamos definir os padrões de desenvolvimento, como por exemplo:
widgets (blocos encaixáveis?)
1) Ter uma pasta widgets dentro do plugin (extensão) ou tema;
2) Dentro desta pasta ter para cada widget uma pasta com o nome da classe dele, e dentro da pasta o arquivo php com o mesmo nome representando a classe;
3) Dois arquivos para os modelos de visualização->view.php, e formulário->form.php;
4) Se for necessário css, coloca-los em uma pasta css;
5) Se for necessário JavaScripts, coloca-los em uma pasta JS e evitar coloca-los dentro do código php ou html;
Blocos de código;
[comando] { [bloco]; } switch { case "": { [bloco]; } break; }
Nomenclatura de arquivos
classes:
1) Mesmo nome da classe;
2) Um arquivo por classe, a não ser em caso muito específico;
…
Formato do Arquivo
1) Fim de linha LF (fim de linha padrão unix)
2) Sem shorttags;
3) Inicio e fim da tag php:
3) Evitar abrir e fechar tags htmls em arquivos separados, como por exemplo abrir no cabeçalho (header) e fechar no rodapé (footer)
Tatiane Gonzaga 12:05 em 6 de novembro de 2013 Link permanente | Faça login para responder
Oi Jacson, sou Tatiane do Pontão de Cultura Digital Ganesha, encaminhei para vocês o nosso tema customizado do P2 (p2-culturaviva) com um doc sobre o que customizamos, qualquer dúvida estamos a disposição 😉
Abraços
Eduardo Zulian 14:46 em 6 de novembro de 2013 Link permanente | Faça login para responder
Oi, Tatiane! Acabei de ver os arquivos aqui. Posso fazer o upload dele e do pdf pro pessoal dar uma olhada?
Tatiane Gonzaga 17:01 em 6 de novembro de 2013 Link permanente
Pode sim 😉
Tatiane Gonzaga 17:06 em 6 de novembro de 2013 Link permanente
Vi que estão discutindo padrões, nós seguimos a estrutura do próprio P2 (que é bem bagunçada…) mas é possível melhorar bastante.
Eduardo Zulian 18:11 em 6 de novembro de 2013 Link permanente
A estrutura de código, você diz?
Tatiane Gonzaga 18:24 em 8 de novembro de 2013 Link permanente
Isso, a estrutura dos códigos
Eduardo Zulian 14:45 em 6 de novembro de 2013 Link permanente | Faça login para responder
Pelo menos para o WP, há alguns padrões já definidos que, dependendo do caso, poderíamos usar para a Rede como base e então traduzir:
CSS: http://make.wordpress.org/core/handbook/coding-standards/css/
PHP: http://make.wordpress.org/core/handbook/coding-standards/php/
HTML: http://make.wordpress.org/core/handbook/coding-standards/html/
Eduardo Zulian 15:03 em 6 de novembro de 2013 Link permanente | Faça login para responder
Mais uma parada: todos os plugins, temas e funcionalidades em WordPress precisamos sempre prever a internacionalização dos termos.
Jacson Passold 15:11 em 6 de novembro de 2013 Link permanente | Faça login para responder
Essa é muito importante mesmo, e também uma das mais complicadas.
Eduardo Zulian 16:15 em 8 de novembro de 2013 Link permanente | Faça login para responder
Adicionei a primeira página ao nosso wiki, contemplando os padrões para CSS: https://github.com/redelivre/redelivre/wiki/_pages
Eduardo Zulian 16:12 em 13 de novembro de 2013 Link permanente | Faça login para responder
@jacson, já chegou a ler sobre isso aqui? Pode ser interessante para basearmos o padrão, o que acha?
http://net.tutsplus.com/tutorials/php/psr-huh/
Jacson Passold 11:04 em 21 de novembro de 2013 Link permanente | Faça login para responder
Citando:
Only use the
Eduardo Zulian 15:16 em 3 de dezembro de 2013 Link permanente | Faça login para responder
A documentação inicial do CSS está aqui, pra quem não viu: https://github.com/redelivre/redelivre/wiki/CSS
Sugestões, amigos?
Eduardo Zulian 16:07 em 5 de dezembro de 2013 Link permanente | Faça login para responder
A dúvida da vez é a seguinte: e aí, commits em português ou em inglês?
Phillipe Trindade 17:50 em 10 de dezembro de 2013 Link permanente | Faça login para responder
Pessoal, achei que estava muito extenso para ficar exibido na íntegra antes de todos os outros posts, então desafixei este post e inseri o link na barra lateral!