Urdu Português
English English Deutsch Deutsch Español Español Français Français Italiano Italiano Nederlands Nederlands Português Português Русский Русский Ελληνικά Ελληνικά
Login



 
Bem-vindo ao Jumi! >> Jumi 2.1 Guia

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

Quando 2.1 mudanças beta para a versão final e 2.0 será marcado como depreciado vamos incorporar este documento para a documentação Jumi padrão.

Intro

Jumi sintaxe do plugin mudou (após três anos) para um diferente. Não há compatibilidade com versões anteriores nesta sintaxe, no entanto você pode usar todos os códigos anteriores personalizados e recursos na liberação 2.1 (e usar novos).

Não há alterações na sintaxe plugin só. As mudanças são em outros lugares. Então leia o documento cuidadosamente, por favor.

Para aqueles que estão muito ansiosos para experimentar a versão nova ou odeio ler "todas as coisas que" aqui é a mudança de sintaxe rápida e suja plugin:

Sintaxe plug-in Old Jumi

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

Nova sintaxe do plugin Jumi

{} 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 alguma explicação geral extensões Jumi então vamos continuar com a forma de atualizar e instalar. No final você vai ter um bom conhecimento sobre "tudo isso".

O conjunto de extensões Jumi

Jumi 2.1 consiste de várias extensões interdependentes:

  • Jumi plugin do sistema (Totalmente reescrito!)
    permite incluir códigos personalizados a partir de vários recursos para Joomla! descrições artigos de conteúdo, e categoria.
    Estabelece Jumi raiz para Jumi componente e módulo Jumi. Os códigos são processados ​​na versão em PDF do Joomla! conteúdo e retirados de RSS.
  • Jumi-editor xtd (Novo!)
    é um Joomla! botão editor que permite a codificação / decodificação de scripts para a sua inclusão direta em Joomla! conteúdo e processamento adicional através do plugin Jumi sistema.
  • Componente Jumi (+ Compartilhada Jumi uso Root)
    cria personalizado Joomla! páginas (os chamados aplicativos Jumi) que contêm código personalizado.
  • Jumi SEF roteador
    é um plugin do sistema que suporta componente Jumi: Ele permite que acessando direto da Jumi aplicação com os seus alias (por exemplo http://www.mysite.com/hello-jumi).
  • Jumi módulo (+ Modo de depuração, + Shared uso Root Jumi)
    é o módulo simples que permite incluir códigos personalizados a partir de vários recursos para Joomla! posições de módulo.
  • Idiomas
    exceto Jumi plugin do roteador existem arquivos de idioma para todas as extensões Jumi para suas traduções fáceis.

Requisitos Jumi 2.1

Nada menos de Joomla! 1.5.8 é necessária.

Upgrade de versões anteriores

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

Se você quiser usar o componente Jumi idade tabela de banco de dados em novo Jumi 2.1 então voltar-se 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 dados de componentes.

O Jumi idade sintaxe plug-in não será processado pelo novo plugin. Você vai ter que reescrever todas as instâncias sintaxe antiga plugin. Lamentamos muito pelo transtorno que lhe trará. Por outro lado ele vai lhe trazer mais possibilidades, melhor segurança e maior flexibilidade. Algo para alguma coisa.

Também remeber que todos 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.

Jumi instalação 2.1

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

Em Jumi 2.1 não há menu principal demonstração "Olá Jumi!" item visível no frontend como era no Jumi 2.0. Alguns de nossos usuários odiá-lo até mesmo como uma demo. Se você quiser você tem que torná-lo visível manualmente: ir para o servidor e publicar o item de menu pré-instalado "Olá Jumi!" aí.

Próximos passos

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

Jumi plugin requer mais explicações. Porque ele usa outra ferramenta: Jumi editor-xtd plugin (botão) 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 codificador (nome de código para Jumi plugin de editor-xtd).
  2. Como editar códigos em Joomla! conteúdo com Jumi codificador.
  3. Como transferir a sintaxe do plugin Jumi antigo para o novo.
  4. Jumi plugin de segurança e outras observações.

Usando Jumi codificador

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

Então, como ele funciona?

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

E aqui vem Jumi codificador. Ele codifica scripts em uma maneira tal que Joomla! e seu editor não reconhecê-lo é um código. No entanto Jumi plugin de reconhecer Jumi sintaxe e tudo entre as 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 é?

Tela de ajuda Jumi Coder

Jumi codificador foi testado com nowysiwyg editor, Tiny MCE, JCE e editores FCK com êxito. O que é grande é 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 em artigo via Jumi programador? Leia e simultaneamente consultar a imagem:

  1. Escrever (ou copiar de alguma fonte) o script para a área do editor de código.
  2. Perceba se você estiver usando Wysiwyg od editor Nowysiwyg. Selecione a codificação em conformidade.
  3. Pressione Encode.
  4. O script é codificado e você obterá o resultado codificado no código de área codificada. (Se você tivesse cometido um erro ou tinha codificado o script em outro tipo de editor, apenas pressione Decode 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 chaves Jumi.

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

Esperamos que ele é 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 incorporação de códigos de script em seu Joomla não! blog também (como blogueiro). O código não será processado, mas será visível como código.

Problema conhecido: se o roteiro é "bem" formatadas (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 agradável é preservada.

É claro que, sem Jumi plugin (instalado e ativado) o próprio script não será executado! Jumi plugin tem para decodificá-lo primeiro. Lembre-se: Jumi Coder e Jumi plugin são gêmeos!

Visão geral da sintaxe

O general Jumi sintaxe do plugin é 2.1

{} Jumi stored_code_source written_code {/ Jumi}

onde

  • stored_code_source é um caminho de arquivo (php, css, js, txt, html, ...) para ser incluído na sintaxe plugin de lugar ou ID (procedeu 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 ele deve ser acondicionado em php tags de início e fim.

Exemplos

1 Exemplo: apenas inclui arquivo php

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

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

{Jumi * 1} {/ Jumi}

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

{jumi * 1} {/ jumi}

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

  1. permite utilizar pré 2.1 arquivos Jumi PHP que usa argumentos Jumi com Jumi sintaxe 2.1 (veremos mais adiante como exatamente),
  2. que é compatível com outras extensões Jumi (módulo componente,): eles têm exactamente o mesmo processamento precedência.

Várias linhas de script escrito

Você não precisa escrever o roteiro escrito entre as tags Jumi em uma linha. Várias linhas são permitidos. (E combinação de tipo de script usado como bem). Por exemplo:

{Jumi * 1}

echo 'Olá O \' Harra ';
?>


document.write ("Sua bebida favorita? ");
graças function () {
window.alert ("Obrigado!")}



Água
Leite
Urso
De outros




{/ Jumi}

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

Antigo Jumi migração sintaxe Plugin

O velho - 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 Component Jumi item de registro de banco de dados.

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

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

Os valores de argumento (neste caso, número do texto "edo" eo número 888) estava acessível no sript php (myfile.php) via $ Jumi [] array. Como esta:


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

Se seus scripts antigos php utiliza $ Jumi [] matriz que você não precisa de lixo deles. Basta definir o array $ Jumi na seção written_code:

{jumi meuarquivo.php} {/ jumi}

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

Esperamos que seja claro e isso vai permitir migrar seus scripts antigos em 2.1 sintaxe do plugin facilmente.

Se você escrever os scripts 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}

$ Name = 'edo';
$ Number = 888;
?>
{/ Jumi}

Lembre: qualquer variável você define fora de 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 interract com a variável de mesmo nome que é definido (por outro desenvolvedor) em outro lugar do Joomla! página.

Então, se você está usando suas próprias variáveis ​​globais dar-lhes nomes e não exóticas.

Novos plugins Jumi questões de segurança

Se você estiver usando Joomla! como um ambiente aberto, isso significa que há 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 em que há um cara que ele ou ela que quer prejudicar ou fazer lucro para o seu próprio. Se o cara está habilitado para incluir os scripts em seu site de forma livre e os scripts serão processados ​​realmente você não será capaz de impedir o cara de total controle do seu site. Não uma idéia muito enoyable, não é 'isso?

O Jumi velha inclui apenas scripts de um arquivo ou de um banco de dados. O intruso poderia usar apenas o que foram em seu site (e ele / ela deve saber a localização). Mas agora, quando a inclusão de script direto é 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 de 2.1 usa essa lista. Se o autor do artigo (Ou grupo ao qual pertence) está na lista negra ou não está na whitelist então Plugin Jumi não processado o código (escrito ou directamente incluídos a partir de um arquivo ou banco de dados) eo código não será visível na extremidade dianteira.

Joomla! itselfs tira o código de artigos. Jumi Coder que está disponível para qualquer um 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ão processados! Ele não será processado, mesmo depois do plugin Jumi é desinstalado - o script é codificado repetimos.

Portanto, se seu whitelist / blacklist está configurado corretamente, não tenha medo. Basta ter cuidado.

O parâmetro "Pathname Padrão Jumi Absoluto", como você sabe que a partir de versões anteriores ainda está lá. Agora estamos usando o nome bem diferente para isso: Root Jumi.

Jumi parâmetro Root permite acessar arquivos de script 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.

Root Jumi foi previamente estabelecido por cada extensão Jumi de forma 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 qualquer feedback de vocês, usuários Jumi. Sobre Jumi si ou esta documentação. Algo está faltando? Alguma dúvida? Algo não funciona como esperado?

Obrigado pelo seu tempo em um avanço!

Jumi (prefarably positivo) feedbacks

Tudo o resto