Jumi 2,1 Průvodce

Představujeme Jumi 2.1 beta pro Joomla! 1.5 zde. Existuje tolik změn v této verzi!

Když 2.1 beta změny do finální verze a 2,0 bude označena jako odepisován budeme začlenit tento dokument do standardní dokumentace Jumi.

Intro

Jumi plugin syntax změnila (po třech letech) na jiný. Není tam žádná zpětná kompatibilita v této syntaxi, ale můžete použít všechny předchozí vlastní kódy a funkce v 2,1 verzi (a používat nové).

Tam nejsou změny ve plugin syntax jen. Změny jsou jinde. Takže dokument číst pozorně, prosím.

Pro ty, kteří jsou příliš dychtiví vyzkoušet novou verzi, nebo nenávidět, aby "všechny ty věci" tady je Quick & Dirty plugin syntax změny:

Staré Jumi plugin syntax

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

Nové Jumi plugin syntax

{Jumi stored_code_source} {written_code / Jumi}

Jak udělat přechod na Jumi 2,1 syntaxi? Budeme to vysvětlit níže. Ale popořadě.

Začněme s nějakým celkovým rozšíření Jumi vysvětlení, pak budeme pokračovat s tím, jak upgradovat a nainstalovat. Na konci budete mít dobrou znalost o "všechny ty věci".

Soubor rozšíření Jumi

Jumi 2,1 skládá z několika vzájemně rozšíření:

Jumi systém plugin (Úplně přepsán!)
umožňuje zahrnout vlastní kódy z několika zdrojů do Joomla! články, obsah a popisy kategorií.
Stanoví Jumi Root pro složku Jumi a Jumi modul. Kódy jsou zpracovány v PDF verzi Joomly! Obsah a svlékl se z RSS.
Jumi editor-XTD (New!)
je Joomla! editor tlačítko, které umožňuje kód / dekódování skripty pro jejich přímé začlenění do Joomla! Obsah a další zpracování systémem Jumi plugin.
Jumi složka (+ Sdílená Jumi Root použití)
vytváří vlastní redakční systém Joomla! stránky (tzv. Jumi Applications) obsahující vlastní kód.
Jumi SFŽP router
je systém, který podporuje plugin Jumi složka: Umožňuje přímý přístup k použití Jumi je to s aliasu (např. http://www.mysite.com/hello-jumi).
Jumi modul (+ Debug módu, + Společný Jumi Root použití)
je jednoduchý modul, který umožňuje zahrnout vlastní kódy z několika zdrojů do Joomla! Modul pozice.
Jazyky
kromě router Jumi plugin tam jsou jazykové soubory pro všechna rozšíření Jumi pro jejich snadnou překlady.

Jumi 2,1 požadavky

Nic méně než Joomla! 1.5.8 je nutné.

Upgrade z předchozích verzí

Doporučujeme kompletně odinstalovat všechny předchozí Jumi rozšíření a nainstalovat Jumi 2,1 balíčku. Zvažte následující:

Pokud chcete používat svůj starý Jumi komponenty databázové tabulky v novém Jumi 2,1 pak zase to nejprve databázový nástroj, který používáte (např. phpMyAdmin). Po instalaci nového balíku můžete obnovit původní Jumi součást databázové tabulky.

Starý Jumi plugin syntax nebudou zpracovávány nový plugin. Budete muset přepisovat každý starý plugin syntax instance. Velice se omlouváme za způsobené nepříjemnosti, že vám přinese. Na druhou stranu to Vám přinese více možností, lepší zabezpečení a větší flexibilitu. Něco za něco.

Také si pamatuji, že všechny Jumi modulů bude zničena během procesu odinstalace. Proto doporučujeme, aby se na vědomí všechny moduly Jumi obsah přinejmenším.

Jumi 2,1 instalace

Nainstalujte balíček jako standardní Joomla! prodloužení. Všechny Jumi rozšíření jsou instalovány v průběhu tohoto jedno-klikněte na proces. Všechny Jumi pluginy jsou nastaveny na "Povolit" příliš.

V Jumi 2,1 není demo hlavním menu "Hello Jumi!" bod viditelný v frontend jak to bylo v Jumi 2,0. Někteří naši uživatelé nenávidět i jako demo. Pokud chcete, můžete mít, aby byl viditelný ručně: "Dobrý den, Jumi" jít do backend a publikovat předinstalované položky menu tam.

Další kroky

Použití Jumi komponent, modulu a router mohl být odvozen od předchozích verzí nebo dokumentace nebo tento tahák. Jumi 2.1 for J!1.5 cheatsheet

Jumi plugin vyžaduje bližší vysvětlení. Protože používá jiný nástroj: Jumi editor-XTD (tlačítko), plugin, který kóduje / dekóduje vlastní skripty a to způsobem, že nejsou odstraněny z Joomla! a jsou zpracovávány Jumi plugin.

Ve zbytku článku se budeme vysvětlovat:

Jak psát kódy do Joomla! obsah s coder Jumi (krycí jméno pro Jumi editor-XTD plugin).
Jak upravit kódy v Joomla! Obsah se kodér Jumi.
Jak převést staré Jumi plugin syntaxi do nového.
Jumi plugin bezpečnostní a jiné poznámky.

Použití Jumi coder

No, podívejte se na video jako první. Budeme to vysvětlit po tom.

Takže jak to funguje?

Víte, když jste patří vlastní skript do Joomla! článek kód budou odstraněny, nebo, v nejlepším, je zakódován do html entity.

A tady přichází Jumi kodér. To zakóduje skripty v takovým způsobem, že Joomla! a jeho editor neuznávají, že je kód. Nicméně Jumi plugin rozpoznat Jumi syntaxe a vše mezi tagy Jumi.

{Jumi stored_code_source} je to prostor mezi tagy pro vaše písemné kód {/} Jumi

dekóduje a vyhodnocuje. Jednoduché, ne?

Jumi coder byl testován s nowysiwyg editor, Tiny MCE, JCE a FCK editory úspěšně. Co je skvělé je, že můžete přepínat mezi editory v žádném editory, jak si přejete. Jumi Coder nezávisí na nich.

Takže ještě jednou, jak zahrnout kód do clanek coder Jumi? Přečtěte si a zároveň konzultovat obrázku:

Napsat (nebo zkopírovat z nějakého zdroje) skript do oblasti editoru kódu.
Uvědomte si, používáte-li WYSIWYG editor od Nowysiwyg. Vyberte kódování způsobem.
Stiskněte kódování.
Skript je zakódován a dostanete výsledek zakódovány do kódu kódované oblasti. (Pokud jste udělali chybu, nebo měl zakódované do skript pro jiný typ editoru, stačí stisknout Decode a opakovat).
Vyberte skript, který vidíte na kódované kód oblasti, zkopírujte jej do schránky (CTRL + C) a vložit (CTRL + V) do Joomla! a mezi složenými značky Jumi.

Chcete-li být zcela jisti, chápete, pojďme se dívat na další video: jak upravit skript, který je již v Joomla! s Jumi Coder.

Doufáme, že je dostatečně jasná.

Takže použití Jumi Coder pro vkládání skriptu do Joomla! a pro její editaci.

Jumi Coder mohou být použity pro vkládání skriptu kódů do vašeho než Joomla! blog taky (jako blogger). Kód nebudou zpracovány, ale bude viditelné jako kód.

Známý problém: Pokud skript je "pěkně" formátu (více řádků, tabulátory atd.), nowysiwyg editor poruší toto formátování (bez ztracených použitelnosti - to bude fungovat). I (MarHaj) nevím, jak se s tím vypořádat.
Ve WYSIWYG editory je zachována pěkná formátování.

Je jasné, že bez Jumi plugin (nainstalována a povolena) scénář sám o sobě nebude pracovat! Jumi plugin má dekódovat jako první. Pamatujte si: Jumi Coder a Jumi plugin jsou dvojčata!

Syntaxe přehled

Obecné Jumi 2,1 plugin syntax je

{Jumi stored_code_source} {written_code / Jumi}

kde

stored_code_source je soubor (php,, css js, txt, html, ...) cesta které mají být zahrnuty v místě plugin syntaxe nebo id (pokračoval s hvězdičkou) bodu složky Jumi a
written_code je nějaký kód. Html, php, js, ot jen text. Pokud php kód pak musí být zabalené do php začátku a konci značky.

Příklady

Příklad 1: jen zahrnuje php souboru

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

Příklad 2: včetně první záznam z Jumi tabulky databáze komponent

{Jumi * 1} {/} Jumi

Příklad 3: obsahuje první záznam z Jumi databes komponent tabulce, která je předcházel (!) Písemným skript.

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

Přednost zpracování written_code -> stored_code_source má dva důvody:

umožňuje využívat již 2,1 Jumi php soubory, které používá Jumi argumenty s Jumi 2,1 syntaxe (uvidíme později, jak přesně),
je kompatibilní s dalšími rozšířeními Jumi (složka, modul): oni dostali přesně stejný zpracování přednost.

Více řádků v psané písmo

Nemusíte psát scénář psaný mezi Jumi značky v jednom řádku. Více řádků jsou povoleny. (A kombinace písma typu používaného také). Například:

{1} Jumi *
<? Php
  echo 'Hello O \' Harra '!;
?>
<div>
  <script type="text/javascript"> language="JavaScript"
    document.write ("Váš oblíbený nápoj <br />?");
    funkce díky () {
     window.alert ("Děkuji vám!")}
  </ Script>
  <form>
    <select name="qq">
      <option> Voda </ option>
      <option> Milk </ option>
      <option> Bear </ option> 
      <option> Ostatní </ option>
     </ Select>
    <input type="button" value="show" onClick="thanks()">
  </ Form> 
<div>
{/} Jumi

Nyní se pojďme zabývat Jumi plugin syntax dozadu nekompatibility.

Staré Jumi plugin syntax migrace

Staré - před 2,1 Jumi - plugin byl s využitím tzv. Jumi argumenty koncepce. To by mohlo projít argumenty (různé hodnoty) do přiloženého souboru nebo složky zahrnuty Jumi záznam v databázi položky.

V tomto případě je syntax byla, jako příklad, jako je tento:

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

Argument hodnoty (v tomto případě číslo text "Edo" a číslo 888) byl přístupný v php sript (myfile.php) přes $ Jumi [] pole. Stejně jako tento:

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

Pokud váš starý PHP skripty využívá $ Jumi [] pole nemusíte odpadky nich. Stačí definovat $ Jumi pole v written_code sekci:

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

A to je důvod, proč je written_code zpracovány před kód je uložen.

Doufáme, že to je jasné, a to umožní přenést vaše staré skripty do 2,1 plugin syntaxe snadno.

Pokud napíšete skripty od nuly můžete definovat v written_code všechny proměnných, které můžete použít v stored_code_source. Například

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

Pamatujte: všechny proměnné definovat mimo funkce, nebo třída se stává globální proměnné. Je to dobré i špatné.

Je to dobré, protože proměnná je přístupná odkudkoli. Je to špatné, protože to může interract s proměnnou se stejným názvem, který je definován (jiný developer) na jiném místě Joomla! stránky.

Takže pokud používáte své vlastní globální proměnné jim značně exotická jména.

Nové Jumi plugin bezpečnostních otázkách

Pokud používáte redakční systém Joomla! jako otevřené prostředí, to znamená, že existuje mnoho lidí, kteří by mohli přispět k obsahu, bezpečnostní otázky mají své hodnoty.

Předpokládejme na chvíli, že je on nebo ona chlap, který chce poškodit nebo vytváření zisku pro jeho vlastní. Pokud je chlap je možnost zahrnout skripty na svůj web volně a skripty budou zpracovány opravdu nebudete schopni zabránit kluk z celkové ovládání vašich webových stránek. Nepříliš enoyable nápad, isnt 'to?

Starý Jumi obsahuje právě skriptů ze souboru nebo z databáze. Vetřelec by mohly používat jen to, co bylo na vaše stránky (a on / ona musí znát umístění). Ale teď, když přímé začlenění skriptu je to možné? To je další dort!

Joomla! Vývojáři zavedly blacklist a whitelist filtrování konceptu do Joomla! 1.5.8. Můžete zabránit těm, kteří jsou na černé listině, nebo nejsou na whitelistu v tom určité "věci".

Jumi plugin 2,1 používá v tomto seznamu. Pokud se Článek autora (Nebo skupiny, do které patří), je v černé listiny nebo není na whitelistu pak Jumi plugin nebudou zpracovávány kód (písemné nebo přímo zahrnuty ze souboru nebo databáze) a kód nebude vidět v předním konci.

Joomla! itselfs pásy ven kód z článků. Jumi Coder, která je komukoliv k dispozici jako editor tlačítko plugin bude obsahovat zakódovaný skript, který Joomla! nebude vyklidit. Thye kód bude tam. Ale nebudou zpracovány! To nebudou zpracovány ani po Jumi plugin odinstalovat - skript je zakódován budeme opakovat.

Takže pokud vaše whitelist je / blacklist nastavena správně, nenechte se nebojí. Jen si dejte pozor.

Parametr "Jumi Výchozí absolutní cestu", jak ji znáte z předchozích verzí, je tam pořád. Nyní se používají spíše jiný název pro to: Jumi Root.

Jumi Root parametr umožňuje přístup k skriptů snadno withoyt psát úplnou cestu k nim znovu a znovu. Můžete umístit skript soubory mimo Joomla! kořenový adresář příliš.

Jumi Root byl dříve zřízené každé prodloužení Jumi samostatně. Nyní je jen na jedno místo, kde můžete nastavit: Jumi plugin. Nastavení je platné pro všechny prodloužení Jumi.

Takže to je prozatím vše

My, vývojáři, Edo mě (MarHaj), potvrdí jakoukoli zpětnou vazbu od vás, uživatelů Jumi. O Jumi sama, nebo tuto dokumentaci. Něco chybí? Něco nejasné? Něco nefunguje jak má?

Díky za váš čas předem!

Jumi (prefarably pozitivní) zpětné vazby

Vše ostatní

Odkazy

Statistika