Estamos introduzindo Jumi 2.1 beta para o Joomla! 1.5 aqui. Há muitas mudanças nesta versão!

Quando as mudanças 2,1 beta para a versão final e 2.0 será marcada como depreciado vamos incorporar esse documento para a documentação Jumi padrão.

Intro

Plugin Jumi sintaxe mudou (após três anos) para uma diferente. Não há compatibilidade com versões anteriores nesta sintaxe, mas você pode usar todos os códigos anteriores personalizados e funcionalidades na versão 2,1 (e utilização de novas).

Não há mudanças no plugin apenas sintaxe. As mudanças estão em outro lugar. Então leia o documento com atenção, por favor.

Para aqueles que estão muito ansiosos para experimentar a versão nova ou odeio ler "todas as coisas que" aqui é o Quick & Dirty plugin mudança de sintaxe:

Antigo plugin Jumi sintaxe

{Jumi [stored_code_source] [arg1] [arg2] ... [ArgN]}

Novo plugin Jumi sintaxe

{Jumi stored_code_source} {written_code jumi /}

Como fazer a transição para Jumi sintaxe 2.1? Vamos explicar abaixo. Mas as primeiras coisas primeiro.

Vamos começar com algumas explicações gerais extensões Jumi então vamos continuar com a forma de atualização e instalar. No final você vai ter um bom conhecimento sobre "tudo isso".

O conjunto de extensões Jumi

Jumi 2,1 consiste em várias extensões interdependentes:

• sistema de plugin Jumi (Totalmente reescrito!)
  permite incluir códigos personalizados a partir de vários recursos para Joomla! artigos, conteúdo e descrições categoria.
  Estabelece Jumi raiz para Jumi componente e módulo Jumi. Os códigos são transformados em PDF versão do Joomla! conteúdo e retirados de RSS.
  
• Jumi-editor xtd (New!)
  é um Joomla! editor botão que permite codificar / decodificar scripts para a sua inclusão direta em Joomla! conteúdo e posterior processamento pelo sistema Jumi plugin.
• componente Jumi (+ Compartilhada Jumi uso Root)
  cria Joomla personalizado! páginas (as chamadas aplicações Jumi) que contém código personalizado.
• Jumi roteador SEF
  é um sistema de plugin que suporta componente Jumi: Permite acesso direto à Jumi aplicativo com ela alias (ex. http://www.mysite.com/hello-jumi).
• módulo Jumi (+ Modo de depuração, + compartilhados Jumi uso Root)
  é o módulo simples que permite incluir códigos personalizados a partir de vários recursos para Joomla! posições módulo.
• Línguas
  exceto roteador plugin Jumi existem arquivos de idioma para todas as extensões de suas traduções Jumi fácil.

Jumi 2.1 Requisitos

Nada menos do que o Joomla! 1.5.8 é obrigatório.

Upgrade de versões anteriores

Recomendamos desinstalar completamente todas as extensões anteriores Jumi e instalar o pacote de 2,1 Jumi. Considere a seguinte:

Se você quiser usar o componente Jumi idade tabela de banco em 2,1 Jumi novo volte-lo primeiro pela ferramenta de banco de dados você está usando (phpMyAdmin, por exemplo). Após a instalação do novo pacote de restaurar o original Jumi tabela do banco de componentes.

O velho Jumi plugin sintaxe não serão processadas pelo novo plugin. Você vai ter que reescrever toda plugin antigo exemplo de sintaxe. Lamentamos muito pelo transtorno que lhe trará. Por outro lado, vai lhe trazer mais possibilidades, melhor segurança e maior flexibilidade. Algo para alguma coisa.

Lembre-se também que todos os Jumi módulos será destruído durante o processo de desinstalação. Então, nós recomendamos que faça uma nota de todo o conteúdo módulos Jumi, pelo menos.

instalação Jumi 2,1

Instalar o pacote como um padrão Joomla! extensão. Todas as extensões Jumi instalados durante o processo de um clique. Todos os plugins Jumi estão definidos para "Ativar" também.

Em Jumi 2,1 não há menu principal demo "Olá Jumi!" item visível na interface como era no Jumi 2.0. Alguns de nossos usuários odiá-lo até mesmo como uma demo. Se você quer, você tem que fazer isso manualmente visível: "Olá! Jumi" ir para o servidor e publicar o item de menu pré-instalado ali.

Próximos passos

Usando o componente Jumi módulo, e um roteador poderia ser deduzida a partir de versões anteriores ou documentação ou este cheatsheet.

Jumi plugin requer mais explicações. Porque ele usa outra ferramenta: Jumi-editor xtd (botão) plugin que codifica / decodifica scripts personalizados de uma forma que eles não são retirados do Joomla! e são processados pelo Jumi plugin.

No resto do artigo, vamos explicar:

1. Como escrever códigos para o Joomla! conteúdo com Jumi codificador (nome de código para Jumi-editor xtd plugin).
2. Como editar códigos em Joomla! conteúdo com codificador Jumi.
3. Como transferir Jumi plugin antigo sintaxe para o novo.
4. Jumi plugin de segurança e outras observações.

Usando o codificador Jumi

Bem, veja o primeiro vídeo. Vamos explicar isso depois.

Assim como ele funciona?

Sabe quando você incluir um script personalizado para o Joomla! artigo do código será removida ou, na melhor das hipóteses, codificado em entidades html.

E aqui vem codificador Jumi. Ele codifica scripts de uma forma tal que o Joomla! e seu editor não reconhecem que é um código. No entanto Jumi plugin Jumi reconhecer a sintaxe e tudo entre as tags Jumi.

{} Stored_code_source jumi este é um espaço entre as tags para o seu código escrito {/ jumi}

decodifica e avalia. Simples, não é?

codificador Jumi foi testado com nowysiwyg editor, Tiny MCE, JCE e editores FCK com êxito. O melhor é que você pode alternar entre os editores sobre a não editores como você deseja. Jumi Coder não dependem deles.

Então mais uma vez como incluir o código no artigo através de codificador Jumi? Leia e simultaneamente consultar a imagem:

1. Escreva (ou copie de alguma fonte), o script na área do editor de código.
   
2. Perceba se você está com o editor Nowysiwyg od. Selecione a codificação em conformidade.
3. Pressione Encode.
4. O script é codificado e você obterá o resultado codificados no código de área codificado. (Se você tivesse cometido um erro ou tinha codificado o script em um outro tipo de editor, apenas pressione decodificação e repetição).
5. Selecione o script que você vê na área de código codificado, copiá-lo para a área de transferência (CTRL + C) e colar (CTRL + V) em Joomla! e entre as tags cacheados Jumi.

Para ter a certeza de que entendem, vamos ver outro vídeo: como editar o script que já está em Joomla! com Jumi Coder.

Esperamos que seja bastante claro.

Portanto, use Jumi Coder para incorporar o script em Joomla! e para a sua edição.

Jumi Coder pode ser usado para a inserção de códigos em seu script não o Joomla! blog também (como o Blogger). O código não será processado, mas será visível como um código.

Conhecido questão: se o script é "muito bem" formatado (várias linhas, guias, etc), então nowysiwyg editor quebra essa formatação (sem a perda de usabilidade - que vai funcionar). I (MarHaj) não sabem como lidar com ele.

Em editores wysiwyg formatação legal é preservada.

É claro que, sem plugin Jumi (instalado e habilitado) o script em si não vai funcionar! Jumi plugin para decodificá-la primeiro. Lembre-se: Jumi Coder e plugin Jumi são gêmeos!

Visão geral da sintaxe

O plugin Jumi geral 2,1 sintaxe é

{Jumi stored_code_source} {written_code jumi /}

onde

• stored_code_source é um arquivo (php, css, js, txt, html, ...) caminho a ser incluídas no local plugin sintaxe ou id (prosseguiu com asterisco) de Jumi item componente e
• written_code é algum código. HTML, PHP, JS, ot apenas um texto. Se o código php, então deve ser envolto em php início e tags de fim.
  

Exemplos

Exemplo 1: apenas inclui arquivo php

{Jumi plugin / sistema / jumi / jumi_demo.php jumi} {/}

Exemplo 2: incluindo o primeiro registro da tabela de banco de Jumi Componente

* {1} {jumi jumi /}

Exemplo 3: inclui o primeiro registro da tabela Jumi databes componente que é precedida (!) O script escrito.

{1} * jumi <? Php echo 'Olá O \' Harra;!?> {/ Jumi}

A precedência de written_code processamento - stored_code_source> tem dois motivos:

1. permite utilizar pré 2,1 arquivos php Jumi que usa argumentos Jumi com Jumi sintaxe 2.1 (veremos mais tarde como exatamente),
   
2. é compatível com outras extensões Jumi (componente, módulo): eles têm exatamente a precedência mesma transformação.
   

Várias linhas de texto escrito

Você não precisa escrever o roteiro escrito entre tags jumi em uma linha. Várias linhas são permitidos. (E a combinação do tipo script utilizado também). Por exemplo:

{1} * jumi
<? Php
  echo 'Olá O \' Harra ';
?>
<div>
  language="JavaScript" type="text/javascript"> <script
    document.write ("Sua bebida favorita /> <br?");
    graças function () {
     window.alert ("Obrigado!");}
  </ Script>
  <form>
    name="qq"> <select
      <option> Água </ option>
      <option> Leite </ option>
      <option> Bear </ option> 
      <option> Outros </ option>
     </ Select>
    <input type="button" value="show" onClick="thanks()">
  </ Form> 
<div>
{/ Jumi}

Agora, vamos lidar com plugin Jumi sintaxe para trás incompatibilidade.

Antigo plugin Jumi migração sintaxe

O antigo - pré 2,1 Jumi - plugin estava utilizando o chamado argumentos Jumi conceito. Poderia passar argumentos (alguns valores) para o arquivo incluído ou incluído Jumi Componente item registro de banco de dados.

Nesse caso, a sintaxe foi, como um exemplo, como este:

{Jumi [myfile.php] [edo] [888]}

Os valores de argumento (neste texto o número de casos "edo" número e 888) estava acessível no sript php (myfile.php) via jumi $ array []. Como esta:

<? Php
  echo $ jumi [0] $ jumi [1] '@ gmail.com'..;
?>

Se a sua idade utiliza scripts PHP $ array [jumi] você não precisa lixo deles. Basta definir o array $ jumi na seção written_code:

Jumi myfile.php {} <php jumi $ = array ('Edo', 888);?> Jumi {/}

E é por isso written_code é processado antes do código armazenado.

Esperamos que seja claro e isto permitirá a migrar seus scripts velhos em 2,1 plugin sintaxe facilmente.

Se você escrever os roteiros a partir do zero você pode definir em written_code qualquer variáveis que você pode usar em stored_code_source. Por exemplo

{Jumi myfile.php}
<? Php
  $ Name = 'Edo';
  Número = $ 888;
?>
{/ Jumi}

Lembre-se: qualquer variável que você define fora da função ou classe torna-se variável global. É bom e ruim.

É bom porque a variável é acessível de qualquer lugar. É ruim porque pode interage com a variável de mesmo nome que está definido (por outro desenvolvedor) em outro lugar do Joomla! página.

Então, se você estiver usando seu próprio variáveis globais e não lhes dar nomes exóticos.

Novo plugin Jumi questões de segurança

Se você estiver usando Joomla! como um ambiente aberto, isso significa que existem muitas pessoas que poderiam contribuir para o conteúdo, as questões de segurança têm seus valores.

Vamos assumir por um momento, há um cara que ele ou ela quem quiser fazer mal ou fazer lucro para si. Se o cara está habilitado para incluir os scripts em seu site de forma livre e os roteiros serão transformados realmente você não será capaz de impedir que o cara do controle total do seu site. Não é idéia muito enoyable isn't, é?

O velho Jumi inclui apenas os scripts de um arquivo ou de um banco de dados. O invasor poderia usar apenas o que foram no seu site (e ele deve saber o local). Mas agora, quando o script de inclusão direta é possível? É mais um bolo!

Joomla! desenvolvedores introduziram blacklist e whitelist filtragem conceito em Joomla! 1.5.8. Você pode impedir que aqueles que estão na lista negra ou não estão na whitelist de fazer certas "coisas".

Jumi plugin 2.1 usa esta lista. Se o autor do artigo (Ou grupo ao qual pertence) está na lista negra ou não está na lista de permissões, em seguida, Jumi plugin não processados o código (escrito diretamente ou incluídos a partir de um arquivo ou banco de dados) eo código não será visível no front end.

Joomla! itselfs retira o código de artigos. Jumi Coder que está disponível para todos como um botão editor plugin incluirá codificado script que o Joomla! não vai limpar. Thye código estará lá. Mas não será processado! Ele não será processado, mesmo depois de Jumi plugin é desinstalado - o script é codificado repetimos.

Portanto, se sua lista de permissões / lista negra está configurado corretamente, não se assuste. Basta ter cuidado.

O parâmetro "Jumi padrão absoluto Caminho", como você sabe que a partir de versões anteriores ainda está lá. Agora estamos usando bastante nome diferente para isso: Jumi Raiz.

Jumi parâmetro Root permite acessar arquivos script facilmente withoyt escrever o caminho completo para os mais e mais. Você pode colocar seus arquivos de script fora do Joomla! diretório raiz também.

Jumi Root foi previamente estabelecido por cada extensão Jumi independente. Agora há apenas um lugar onde você pode configurá-lo: Jumi plugin. A configuração é válida para toda a extensão Jumi.

Então isso é tudo por agora

Nós, desenvolvedores, Edo um me (MarHaj), irá reconhecer qualquer feedback de seus usuários, Jumi. Sobre Jumi si ou documentação. Alguma coisa está faltando? Algo obscuro? Algo não funciona como esperado?

Obrigado pelo seu tempo em um avanço!

Jumi (prefarably positivo) feedbacks

Tudo o resto