Jumi 2,1 Guide

Estamos introduzindo Jumi beta 2.1 para Joomla! 1,5 aqui. Há tantas mudanças nesta versão!

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

Intro

Jumi sintaxe plugin mudou (depois de três anos) para uma diferente. Não há compatibilidade com versões anteriores nesta sintaxe, porém você pode usar todos os códigos de costume anterior e em 2,1 liberação de recursos (e usar novos).

Não há mudanças na sintaxe plugin só. As mudanças são em outros lugares. Portanto, leia atentamente o documento, por favor.

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

Old sintaxe plugin Jumi

  (jumi stored_code_source [] [arg1] [arg2] ...  [argN]) 

Nova sintaxe plugin Jumi

  jumi stored_code_source) ((written_code / jumi) 

Como fazer a transição para Jumi 2,1 sintaxe? Vamos explicar abaixo. Mas primeiras coisas primeiro.

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

O conjunto de extensões Jumi

Jumi 2,1 consiste em diversas extensões interdependentes:

• Jumi plugin (sistema totalmente refeito!)
  permite incluir códigos personalizados de diversos recursos em Joomla! artigos, conteúdo e descrições de categoria.
  Estabelece Root Jumi 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! botão editor que permite codificar / decodificar scripts para a sua inclusão direta em Joomla! transformação de conteúdo e ainda por Jumi plugin sistema.
• Componente Jumi (+ compartilhada Jumi uso Root)
  cria personalizado Joomla! páginas (o chamado Jumi Applications) que contém código personalizado.
• Jumi roteador SEF
  é um plugin do sistema que suporta componente Jumi: Permite acesso direto à aplicação Jumi com o seu apelido (por exemplo, http://www.mysite.com/hello-jumi).
• Módulo Jumi (+ modo Debug, + uso compartilhado Jumi Root)
  é o módulo simples que permite incluir códigos personalizados de diversos recursos em Joomla! posições módulo.
• Idiomas
  exceto Jumi plugin roteador há arquivos de linguagem para todas as extensões Jumi para suas traduções fácil.

Jumi 2,1 exigências

Nada menos de Joomla! 1.5.8 é requerido.

Atualização de versões anteriores

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

Se você quiser usar seu antigo Jumi tabela de banco de componentes em novos Jumi 2,1 então guardá-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 de banco de componentes.

A sintaxe plugin antigo Jumi não serão processados pelo novo plugin. Você vai ter que reescrever todos os casos, sintaxe antigo plugin. Lamentamos muito pela inconveniência que irá lhe trazer. Por outro lado, irá trazer-lhe mais possibilidades, melhor segurança e maior flexibilidade. Algo para alguma coisa.

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

Jumi instalação 2,1

Instalar o pacote como um standard Joomla! extensão. Todas as extensões Jumi são instalados durante este processo de um clique. Todos os plugins Jumi são definidas como "Enable" também.

Em Jumi 2,1 não há demo do menu principal "Olá Jumi!" item visível no frontend como era no Jumi 2,0. Alguns de nossos usuários odiá-lo mesmo como uma demo. Se você quiser que você tem que torná-la visível manualmente: Vá para o servidor e publicar o item de menu pré-instalado "Olá Jumi!" lá.

Próximas etapas

Usando Jumi componente, módulo e roteador poderia ser deduzida a partir de lançamentos anteriores ou documentação ou esta folha.

Plugin Jumi exige mais explicações. Porque ele usa uma outra ferramenta: o editor-Jumi 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 plugin Jumi.

No resto do artigo, vamos explicar:

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

Usando o codificador Jumi

Bem, veja o primeiro vídeo. Vamos explicá-lo depois disso.

Assim como ele funciona?

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

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

  (jumi stored_code_source) Este é um espaço entre as tags para o seu código escrito (/ jumi) 

decodifica e avalia. Simples, não é?

Coder Jumi foi testado com nowysiwyg editor Tiny MCE, JCE e editores FCK com êxito. O que é grande é que você pode alternar entre editores em nenhum editores como você deseja. Jumi Coder não dependem deles.

Então, mais uma vez como incluir o código em artigo via codificador Jumi? Ler e simultaneamente consultar a imagem:

1. Escrever (ou copiar de alguma fonte) o roteiro para a área de editor de código.
   
2. Perceba se você está com o editor Nowysiwyg od. Selecione a codificação em conformidade.
3. Imprensa Encode.
4. O script é codificado e você obterá o resultado codificado para a área de código codificado. (Se você cometeu um erro ou tinha codificado o script em um outro tipo de editor, basta pressionar Decode e repetir).
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) no Joomla! e entre as tags curly Jumi.

Para ter a certeza que você entender, vamos ver outro vídeo: Como editar o script que já está em Joomla! com Jumi Coder.

Esperamos que seja suficientemente claro.

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

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

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

Em editores WYSIWYG nice formatação é preservada.

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

Resumo Sintaxe

A sintaxe geral Jumi plugin é 2,1

  jumi stored_code_source) ((written_code / jumi) 

onde

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

Exemplos

Exemplo 1: apenas inclui o arquivo php

  (jumi plugin system / jumi / jumi_demo.php) (/ jumi) 

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

  jumi * (1) (/ jumi) 

Exemplo 3: inclui o primeiro registro de Jumi Componente databes mesa, que é precedido (!) Pelo script escrito.

  (jumi * 1) </ echo php? 'Olá O \' Harra ';?> (/ jumi) 

A precedência de written_code processamento -> stored_code_source tem duas razões:

1. que permite utilizar pré 2,1 Jumi arquivos PHP que usa argumentos Jumi com Jumi sintaxe 2,1 (veremos mais adiante como exatamente),
   
2. ele é compatível com outras extensões Jumi (component, module): eles têm exatamente a precedência mesma transformação.
   

Várias linhas de script escrito

Você não precisa escrever o roteiro escrito entre tags jumi em uma linha. Linhas múltiplas são permitidas. (E combinação de tipo script utilizado também). Por exemplo:

  jumi * (1) 
  <? php 
  echo 'Olá O \' Harra '; 
  ?> 
  <div> 
  <script language="JavaScript" type="text/javascript"> 
  document.write ( "Sua bebida favorita? <br />"); 
  graças function () ( 
  window.alert ( "Obrigado!")) 
  </ script> 
  <form> 
  <select name="qq"> 
  <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 Jumi sintaxe plugin para trás incompatibilidade.

Old Jumi migração sintaxe plugin

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

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

  (jumi [myfile.php] [Edo] [888]) 

Os valores de argumento (neste número do caso "edo" eo número 888) foi acessível no sript php (myfile.php) via $ jumi [matriz]. Como esta:

  <? php 
  echo $ jumi [0]. $ jumi [1]. "@ gmail.com"; 
  ?> 

Se seus scripts PHP de idade utiliza $ jumi [] array você não precisa de lixo deles. Basta definir a matriz $ jumi na secçã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 é clara e isso permitirá a migrar seus scripts antigos para 2,1 sintaxe plugin facilmente.

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

  (jumi myfile.php) 
  <? php 
  $ name = 'edo'; 
  $ number = 888; 
  ?> 
  (/ jumi) 

Lembre-se: qualquer variável que você definir a função fora 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 é definido (por outro desenvolvedor) em outro lugar do Joomla! página.

Portanto, se você estiver usando seu próprio variáveis globais dar-lhes nomes bastante exóticos.

Nova Jumi plugin 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 os seus valores.

Vamos assumir por um momento, há um que ele ou ela cara que quer para prejudicar ou fazer lucro para o seu próprio. Se o cara está habilitado para incluir os scripts em seu site livremente e os scripts serão processados mesmo que você não será capaz de impedir o cara do controle total do seu site. Não uma idéia muito enoyable, isnt 'it?

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

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

Jumi plugin 2,1 usa essa lista. Se o autor do artigo (ou grupo a que pertence) está na lista negra ou não está na lista de permissões, em seguida, plugin Jumi não será processado no código (por escrito ou diretamente incluídas a partir de um arquivo ou banco de dados) eo código não será visível na parte dianteira fim.

Joomla! tiras itselfs o código de artigos. Jumi Coder que está disponível para todos como um plugin botão editor irá incluir script codificado que Joomla! não vai limpar. Thye código estará lá. Mas não será processada! Não serão processados mesmo após plugin Jumi é desinstalado - o script é codificado repetimos.

Então, se sua lista de permissões / lista negra está definida corretamente, não tenha medo. Basta ter cuidado.

Parâmetro "Jumi Caminho padrão absoluto", como você sabe que a partir de lançamentos anteriores ainda está lá. Agora estamos usando o nome bastante diferente para isso: Root Jumi.

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

Raiz Jumi foi previamente estabelecidos por cada extensão Jumi independente. Agora há apenas um lugar onde você pode configurá-lo: plugin Jumi. 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 todo o feedback de vocês, usuários Jumi. Sobre Jumi si ou documentação. Algo 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