[VIDEO] Fazendo a atualização de um plugin para 1.6

é hora de desenvolvedores para começar a pensar sobre a atualização de seus componentes para ficar pronto. Na verdade, agora é um ótimo momento para começar. Andrew Eddie percorre como ele atualizou um plugin editor simples com este vídeo-aula para os desenvolvedores.
Vimeo

Note que, enquanto este vídeo é sobre como atualizar um plugin simples, as alterações feitas ao arquivo de manifesto XML e arquivos de idiomas também são aplicáveis ??para Joomla 1.6 componentes, módulos e templates.



Se você gostaria de discutir este vídeo, visite o nosso grupo em people.joomla.org. Se você estiver interessado em traduzir a transcrição abaixo, entre em contato conosco.

Transcrição de vídeo



Introdução

Tenho acabado de atualizar um dos meus plugins para estar pronto para Joomla 1.6 e eu pensei que eu iria partilhar como eu fiz isso, esperamos começá-lo para a linha de chegada com menos de tentativa e erro do que eu tinha. O processo é simples, mas existem alguns passos envolvidos. Mas antes de começar, lembre-se sempre de ativar o Site Debug e Debug Language e aumentar o Relatório de Erros para máxima em Configuração Global antes de começar.


Ramificação

Então, como você pode ver, eu salvei a minha extensão no Subversion em Joomlacode.org. A primeira coisa que fiz foi copiar o meu tronco existente a um ramo novo no J1.6. Sei que algumas pessoas vão tentar fazer um único pacote que suporta ambas as versões, e se você quiser fazê-lo dessa maneira que está tudo bem comigo, mas meu conselho é fazer o seu 1.5 e seu 1,6 versões em árvores separadas. Eu, pessoalmente, acho que é melhor para você fazer isso a longo prazo.


Alterações no formato de arquivo

Vamos dar uma olhada no formato de plugin de idade. Em 1,5 que normalmente têm os arquivos do plugin do PHP e XML na pasta do grupo de plugin, e então se você tiver quaisquer outros arquivos de suporte você manter aqueles tipicamente em uma subpasta com o mesmo nome do plugin.

Se olharmos para o ramo 1.6, podemos ver que o plugin está agora em sua própria pasta, tendo o mesmo nome do plugin, no exatamente da mesma forma como faríamos para um módulo. Dos arquivos do plugin do PHP e XML são agora nesta subpasta, ao invés de no mesmo nível, como vimos na versão 1.5. Você também pode ver que eu tenho uma coleção de outras pastas que contenham arquivos que suportam o plugin. Vamos olhar para aqueles com mais detalhes em breve.


Formato do arquivo PHP

O código para o seu plugin deve ser feito usando uma classe PHP prorrogado a partir de JPlugin. Se você for fazê-lo desta forma já para 1.5, então não há mais mudanças que você precisa fazer, exceto onde nomes de eventos foram alterados no 1.6, e há alguns desses. Para mais informações sobre as alterações nome do evento, ver o wiki de documentação Joomla.


XML File Format

Agora, ao contrário do arquivo PHP, há uma série de mudanças importantes para fazer para o arquivo XML para que ele funcione corretamente em 1,6.

A primeira mudança é fácil. Basta renomear a tag raiz para .

A segunda mudança eu tive que fazer foi adicionar as novas pastas de apoio para a tag . Que foi o segundo bit fácil.

A terceira mudança é um pouco mais complicado. Vamos dar uma olhada nos arquivos velhos do XML primeiro. Você pode ver os parâmetros do plugin para nós usamos um conjunto de tags (plural ) e (singular). A maioria de vocês deve estar muito familiarizado com aqueles. Se você está acostumado a definir seus elementos JParameter própria, você também têm vindo a utilizar o atributo na tag addpath .

Agora, vamos voltar para a versão 1.6 deste arquivo. Você pode ver a estrutura XML é um pouco diferente, mas não é muito difícil de seguir e esta estrutura também se aplica aos componentes, módulos e templates. A API para fazer parâmetros de extensão mudou de usar a classe JParameter ao uso de uma nova classe chamada JForm que é muito mais poderoso.


O primeiro passo para melhorar esta área é simplesmente busca de todas as marcas e renomeá-los para tags . Todos os elementos JParameter foram portados através de campos para JForm geralmente não há alteração na lista de argumentos.

O segundo passo aqui é renomear as tags de tags

e com isso você precisa dar o tag um atributo de nome. Na maioria dos caso, o atributo nome vai ser " básico" ou " avançado" e isso vai refletir o controle deslizante dois painéis que foram suportados na versão 1.5. No entanto, em 1,6 você pode adicionar tags como muitos como você deseja que aparecerá como sliders adicional quando você editar o plugin.
O terceiro passo é envolver toda a coleção de tags

em uma tag que tem um atributo nome do params que é o nome real do campo da tabela do banco de dados que as informações serão armazenadas dentro Como um aparte, nós não mais parâmetros loja em formato INI, mas mudaram para o formato JSON. Você não precisa se preocupar em converter o valor base de dados como Joomla faz isso em tempo real.
Se você estiver usando elementos JParameter personalizado, então você precisa mudar o nome do atributo para addpath addfieldpath e um bom lugar para colocar o que há no tag . No entanto, você também vai precisar para converter seus elementos JParameter personalizado em campos JForm mas vamos olhar para isso outra vez.

Último de todos, nós envolvemos a tag em uma tag fazer delinear a marcação JForm do resto do manifesto de extensão.

No final do arquivo, eu também acrescentei algumas novas tags que estão disponíveis na versão 1.6. A tag permite que você adicione uma classe de instalador com métodos que podem disparar sobre instalação, atualização e remoção, bem como antes e depois do processo de instalação. A tag permite a você registrar um arquivo de atualização XML em seu site que pode olhar para Joomla e determinar se ele tem a versão mais recente de sua extensão.

Formato de arquivo de linguagem

Agora, vamos passar para arquivos de idioma. Estas podem agora ser incluídos, e eu recomendo sempre fazê-lo desta maneira, com o pacote de plugin em pastas que espelhar a estrutura das pastas língua principal Joomla. Em todos os casos, você terá pelo menos language/en-GB. A convenção de nomenclatura para os arquivos é o mesmo, mas há um novo arquivo de linguagem com a extensão. sys.ini onde você pode incluir seqüências de linguagem que são necessários durante o processo de instalação.

Olhando para os arquivos diretamente, eles são muito semelhantes as versões do 1,5 . No entanto, porque estamos usando o analisador INI nativa do PHP, o formato é muito mais rigoroso. As teclas de linguagem só pode conter letras, números e underscores. Espaços e outros caracteres de pontuação irá causar um erro se eles estão presentes nas chaves. Os valores da seqüência devem ser acondicionados em double quotes. Agora, há um pequeno problema se você precisa incluir double quotes na seqüência em si. Infelizmente PHP 5.2 e 5.3 se comportam de maneira diferente e não podemos usar uma barra invertida para escapar do double quotes. Para incluir um aspas duplas dentro da string você deve substituí-la por "_QQ_". O que isto é realmente quebra a string em duas partes e concatena -lo com uma constante chamada de PHP _QQ_ que avalia a um single double quotes. Se isso parece muito estranho para você, assim que é, mas apenas confiar em mim que é a única maneira para que ele funcione em várias versões do PHP de forma confiável.

Considerações Finais

Então, esse é o tour rápido e com todas essas mudanças, então você pode empacotar seu plugin em um formato compactado como faria para Joomla 1.5 e começar a distribuí-lo. Espero que este vídeo vai ajudar a guiá-lo com segurança através de seus preparativos para apoiar Joomla 1.6 - porque, sério, é complicado para uso e desenvolvimento. Obrigado por ouvir, ler, boa sorte na codificação .

Fonte: http://goo.gl/j1oId

Inserido em nossos servidores e movido para videos.

ABs, Trorram <!-- s:lol: --><img src="{SMILIES_PATH}/icon_lol.gif" alt="" title="Rindo" /><!-- s:lol: -->