Estamos introducindo Jumi beta 2.1 para Joomla! 1,5 aquí. Hai tantos cambios nesta versión!

Cando 2,1 cambios en beta da versión final e 2.0 hase marcar como depreciado que ha incorporar este documento para a documentación Jumi estándar.

Intro

Jumi sintaxe do plugin cambiou (despois de tres anos) para un diferente. Non hai compatibilidade con versións anteriores nesta sintaxe, con todo pode usar todos os códigos anteriores personalizados e recursos en 2.1 release (e utilizar novos).

Non hai cambios na sintaxe único plugin. Os cambios son noutros lugares. Entón lea o documento coidadosamente, por favor.

Para os que están moi ansiosos para probar a nova versión ou odio ler "todas as cousas que" aquí é o cambio de sintaxe rápido e Dirty plugin:

Sintaxe plugin de idade Jumi

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

Nova sintaxe do plugin Jumi

{Jumi stored_code_source} {written_code jumi /}

Como facer a transición cara Jumi sintaxe 2.1? Imos explicalo-lo seguinte. Mais as primeiras cousas primeiro.

Imos comezar con algunhas extensións Jumi xeral explicación entón imos continuar coa forma de actualización e instalar. Ao final vai ter un bo coñecemento sobre "todo isto".

O conxunto de extensións Jumi

Jumi 2,1 consiste en varias extensións interdependentes:

• Jumi plugin do sistema (Totalmente reescrito!)
  permite incluír códigos personalizados de varios recursos para Joomla! artigos, contido e descricións categoría.
  Establece Jumi raíz Jumi compoñente e módulos Jumi. Códigos son procesados ​​na versión en PDF do Joomla! contido e retirados de RSS.
  
• Jumi-editor XTD (Novo!)
  é un Joomla! editor botón que permite codificar / decodificar scripts para a súa inclusión directa en Joomla! contido e tratamento por Jumi plugin do sistema.
• Compoñente Jumi (+ Compartida uso Jumi Root)
  crea custom Joomla! páxinas (as chamadas aplicacións Jumi) que conteñen código personalizado.
• Jumi SEF router
  é un plugin do sistema que soporta compoñente Jumi: Permite o acceso directo de Jumi aplicación co seu alias (por exemplo http://www.mysite.com/hello-jumi).
• Jumi módulo (+ Modo depuración, + Shared uso Jumi Root)
  é o módulo simple que permite incluír códigos personalizados de varios recursos para Joomla! posicións de módulo.
• Linguas
  excepto Jumi plugin do router existen arquivos de idioma para todas as extensións Jumi para as súas traducións doado.

Jumi 2.1 Requisitos

Nada menos que Joomla! 1.5.8 é necesaria.

Actualización de versións anteriores

Recomendamos desinstalar completamente todas as extensións anteriores Jumi e instalar o paquete de 2,1 Jumi. Considere a continuación:

Se quere usar o compoñente Jumi idade táboa de base en novas Jumi 2,1, a continuación, volverse primeiro pola ferramenta de base de datos está a usar (phpMyAdmin, por exemplo). Despois da instalación do novo paquete de restaurar o orixinal Jumi táboa da base de compoñentes.

O Jumi idade sintaxe do plugin non será procesado polo novo plugin. Vai ter que reescribir todas as instancias sintaxe antiga extensión. Sentímolo moito por calquera inconveniente que lle traerá. Por outra banda el lle vai traer máis posibilidades, mellor seguridade e maior flexibilidade. Algo para algo.

Lembra tamén que todos os Jumi módulos será destruído durante o proceso de desinstalación. Por iso recomendamos que faga unha nota de todo o contido módulos Jumi, polo menos.

Jumi instalación 2.1

Instala o pacote como un estándar Joomla! extensión. Todas as extensións Jumi se instalan durante este proceso de un click. Todos os plugins Jumi están definidos con "Activar" tamén.

En Jumi 2,1 non hai menú principal demostración "Ola Jumi!" elemento visible no interface como era no Jumi 2.0. Algúns dos nosos usuarios odialo ata como unha demo. Se quere ten que facelo visible manualmente: vaia ao servidor e publicar o elemento de menú pre-instalado "Ola Jumi!" alí.

Próximos pasos

Usando o compoñente Jumi módulo e router podería ser deducidos a partir de versións anteriores ou documentación ou este cheatsheet.

Extensión Jumi require máis explicacións. Porque usa outra ferramenta: Jumi editor-XTD plugin (botón) que codifica / decodifica scripts personalizados de forma que eles non son retirados do Joomla! e son procesados ​​polo plugin de Jumi.

No resto do artigo, imos explicar:

1. Como escribir código para Joomla! contidos Jumi codificación (nome de código para Jumi plugin do editor-XTD).
2. Como editar códigos en Joomla! contidos Jumi codificación.
3. Como trasladar a sintaxe do plugin Jumi vella da nova.
4. Jumi plugin de seguridade e outras observacións.

Jumi usando coder

Ben, vexa o primeiro vídeo. Imos explicalo lo despois diso.

Entón, como funciona?

Vostede sabe cando incluír nun guión personalizado Joomla! código do artigo da vontade ser retirados ou, no mellor dos casos, codificado en entidades html.

E aquí vén Jumi codificación. El codifica scripts de forma tal que Joomla! eo seu editor non recoñecen que é un código. Con todo Jumi plugin de recoñecer Jumi sintaxe e todo entre as etiquetas Jumi.

{} Jumi stored_code_source este é un espazo entre as etiquetas para o seu código escrito {/ Jumi}

decodifica e valora. Simple, verdade?

Jumi codificación foi probado con nowysiwyg editor, Tiny MCE, JCE e editores fck con éxito. O que é grande é que pode cambiar entre editores en ningún editores como quere. Jumi Coder non dependen deles.

Entón unha vez máis como incluír o código en artigo vía Jumi coder? Ler e á vez consultar a imaxe:

1. Escribir (ou copia dunha fonte) o guión para a área de editor de código.
   
2. Entender se está a usar WYSIWYG od Nowysiwyg editor. Seleccione a codificación de conformidade.
3. Prema Encode.
4. O guión é codificación e obter o resultado codificado no código de área codificado. (Se tivese cometido un erro ou tiña codificado a escritura en outro tipo de editor, só prema decoder e repetir).
5. Seleccione o arquivo que aparecen na área de código codificado, copia-lo para a área de transferencia (CTRL + C) e pegalo (CTRL + V) en Joomla! e unha das etiquetas curly Jumi.

Para estar seguro que entender, imos ver outro video: como editar a escritura que xa está en Joomla! con Jumi Coder.

Esperamos que é bastante claro.

Polo tanto, use Jumi Coder para incorporar a escritura en Joomla! e para a súa edición.

Jumi Coder se pode usar para a incorporación de códigos de escritura no seu Joomla non! blog (como o blogger). O código non será procesado, pero será visible como código.

Problemas coñecidos: o guión é "moi ben" formatado (varias liñas, guías, etc), entón nowysiwyg editor rompe esa formato (sen perda de usabilidade - que vai funcionar). I (MarHaj) non saben tratar con el.

En editores WYSIWYG formato legal é preservada.

Por suposto, sen Jumi plugin (instalar e activado), o propio script non será executado! Jumi plugin ten para decodifica-lo primeiro. Teña en conta que: Jumi Coder e Jumi plugin son xemelgos!

Descrición xeral da sintaxe

O xeneral Jumi sintaxe plugin 2.1 é

{Jumi stored_code_source} {written_code jumi /}

onde

• stored_code_source é un arquivo (php, css, js, txt, html, ...) camiño para ser incluído na sintaxe plugin de lugar ou id (proseguiu con asterisco) de Jumi elemento de compoñente e
• written_code é un código. Html, php, js, ot só un texto. Se o código php, entón debe ser envolto en php inicio e etiquetas de fin.
  

Exemplos

Exemplo 1: só inclúe arquivo php

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

Exemplo 2: incluíndo o primeiro rexistro da táboa da base Jumi Component

{Jumi * 1} {/ Jumi}

Exemplo 3: inclúe o primeiro rexistro da táboa Jumi databes compoñente que é precedida (!) Polo script escrito.

{1} * Jumi <php echo'Olá O \'Harri';?> {/ Jumi}

A precedencia de procesamento written_code -> stored_code_source ten dúas razóns:

1. permite utilizar pre 2,1 Jumi ficheiros php que usa argumentos Jumi con Jumi sintaxe 2.1 (veremos máis adiante como exactamente),
   
2. é compatible con outras extensións Jumi (módulo compoñente): eles teñen exactamente o mesmo procesamento de precedencia.
   

Varias liñas no guión escrito

Non é preciso escribir o guión escrito entre as etiquetas Jumi nunha liña. Varias liñas se permiten. (E combinación de tipo de escritura utilizado tamén). Por exemplo:

{1} * Jumi
<? PHP
  echo 'Ola O \' Harri ';
?>
<div>
  <script type="text/javascript"> language = "Javascript"
    document.write ("A súa bebida favorita <br />?");
    grazas function () {
     window.alert ("Grazas!")}
  </ Script>
  <form>
    <select name="qq">
      <option> Auga </ option>
      <option> Leite </ option>
      <option> Oso </ option> 
      <option> Outros </ option>
     </ Select>
    <input type="button" value="show" onClick="thanks()">
  </ Form> 
<div>
{/ Jumi}

Agora imos tratar con Jumi incompatibilidade para atrás plugin de sintaxe.

Old Jumi migración sintaxe do plugin

O vello - pre 2,1 Jumi - plugin estaba utilizando o chamado Argumentos Jumi concepto. Podería pasar argumentos (algúns valores) para o arquivo incluído ou incluída Component Jumi elemento de rexistro de base de datos.

Neste caso, a sintaxe foi, como un exemplo, como este:

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

Os valores de argumento (neste caso, número do texto "edo" eo número 888) estaba accesible no sript php (myfile.php) vía $ Jumi [] array. Como este:

<? PHP
  echo $ Jumi [0] $ Jumi [1] '@ gmail.com' ..;
?>

Se os seus scripts vellos php utiliza $ Jumi [array] non precisa de trash-los. Basta configurar o array $ Jumi na sección written_code:

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

E é por iso written_code é procesado antes do código gardado.

Agardamos que é clara e iso permitirá a migrar os seus scripts vellos en 2,1 plugin de sintaxe facilmente.

Se escribir os guións a partir de cero pode definir en written_code calquera variables que pode usar en stored_code_source. Por exemplo

{Jumi myfile.php}
<? PHP
  $ Name = 'edo';
  $ Number = 888;
?>
{/ Jumi}

Teña en conta que: calquera variable que define fóra da función ou clase convértese en variable global. É bo e malo.

É bo porque a variable é accesible desde calquera lugar. É malo porque pode interract coa variable de mesmo nome, que é definido (por outro creador) noutro lugar de Joomla! páxina.

Entón, se está a usar as súas propias variables globais darlles nomes moi exótico.

Novo plugin de Jumi cuestións de seguridade

Se está usando Joomla! como un ambiente aberto, iso significa que hai moitas persoas que poderían contribuír ao contido, as cuestións de seguridade teñen os seus valores.

Supoñamos por un momento hai unha cara que el ou ela que quere facer mal ou facer beneficio para o seu propio. Se a cara é habilitado para incluír os scripts no seu sitio web de forma libre e os scripts serán tratados en realidade non será capaz de impedir que a cara do control total do seu sitio. Non unha idea moi enoyable, non é 'iso?

A vella Jumi inclúe só scripts dun arquivo ou dun banco de datos. O intruso podería usar só o que foron no seu sitio (e que el / ela debe coñecer o lugar). Pero agora, cando a inclusión guión directo é posible? É máis unha torta!

Joomla! desenvolvedores introduciron Blacklist e whitelist filtrado concepto en Joomla! 1.5.8. Pode evitar que os que están na lista negra ou non están na whitelist de facer certas "cousas".

Jumi plugin 2.1 usa esa lista. Se o autor do artigo (Ou grupo ao que pertence) está na lista negra ou non está na whitelist entón Jumi Extensión non procesados o código (escrito ou directamente incluídas a partir dun arquivo ou base de datos) eo código non será visible no front-end.

Joomla! itselfs tiras o código de artigos. Jumi Coder que está dispoñible para calquera como un complemento botón editor pode incluír script codificado que Joomla! non vai borrar. Thye código estará alí. Pero non se procesará máis! Non será procesado, mesmo despois do plugin Jumi é desinstalar - a escritura é codificación repetimos.

Polo tanto, se o seu whitelist / Blacklist está configurado correctamente, non teña medo. Só ten que ter coidado.

Parámetro "Pathname defecto Jumi Absoluto", como vostede sabe que a partir de versións anteriores aínda está alí. Agora estamos a usar o nome un pouco diferente para iso: Root Jumi.

Jumi parámetro Root permite descargar de script facilmente withoyt escribir a ruta completa para os máis e máis. Podes poñer os seus arquivos de script fóra Joomla! directorio raíz tamén.

Root Jumi xa vén establecidos por cada extensión Jumi de forma independente. Agora hai só un lugar onde podes configure-lo: complemento Jumi. A configuración é válida para toda a extensión Jumi.

Entón iso é todo por agora

Nós, desenvolvedores, Edo un me (MarHaj), ha recoñecer calquera feedback de vós, os usuarios Jumi. Jumi sobre si mesmo ou esta documentación. Algo que falta? Algo confuso? Algo non funciona como se esperaba?

Grazas polo seu tempo nun avance!

Jumi (prefarably positivo) feedbacks

Todo o resto