Jumi 2,1 Gids

Wij introduceren Jumi 2.1 Beta voor Joomla! 1.5 hier. Er zijn zo veel veranderingen in deze versie!

Bij 2.1 Beta wijzigingen in de definitieve versie en 2.0 zal worden gemarkeerd als afgeschreven zullen we dit document op te nemen in de standaard Jumi documentatie.

Intro

Jumi plugin syntaxis is veranderd (na drie jaar) in iets anders. Er is geen achterwaartse compatibiliteit in deze syntax, maar u alle vorige aangepaste codes en functies kunnen gebruiken in 2.1 release (en gebruik nieuwe).

Er zijn geen veranderingen in de plugin syntax alleen. Wijzigingen worden elders. Dus lees het document zorgvuldig, alsjeblieft.

Voor degenen die te popelen om nieuwe versie te proberen of haat te lezen "al dat spul" hier is de Quick & Dirty plugin syntaxis te wijzigen:

Oude Jumi plugin syntaxis

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

Nieuwe Jumi plugin syntaxis

  Jumi stored_code_source () written_code (/ Jumi) 

Hoe maak je de overgang naar Jumi 2,1 syntaxis? We zullen het hieronder. Maar eerst iets anders.

Laten we beginnen met een algemeen Jumi extensies uitleg dan zullen we doorgaan met hoe om te upgraden en te installeren. Aan het eind krijgt u een goede kennis over "al dat spul".

De reeks Jumi extensies

Jumi 2.1 bestaat uit verschillende onderling afhankelijke extensies:

• Jumi systeem plugin (Totally herschreven!)
  in staat stelt om onder andere voor aangepaste codes van verschillende middelen in Joomla! artikelen, inhoud en categorie beschrijvingen.
  Het zet Jumi Root voor Jumi component en Jumi module. Codes worden verwerkt in PDF-versie van Joomla! inhoud en gestript uit RSS.
  
• Jumi editor-XTD (Nieuw!)
  is een Joomla! redacteur knop die het mogelijk maakt om code / decoderen scripts voor hun directe integratie in Joomla! inhoud en de verdere verwerking door Jumi systeem plugin.
• Jumi component (+ gedeelde Jumi Root gebruik)
  creëert custom Joomla! pagina's (zogenaamde Jumi Applications) met aangepaste code.
• Jumi SEF router
  is een systeem plugin die Jumi component ondersteunt: Het maakt directe toegang tot de toepassing van Jumi met zijn alias (bijv. http://www.mysite.com/hello-jumi).
• Jumi module (+ Debug mode, + Gedeelde Jumi Root gebruik)
  is eenvoudig module die het mogelijk maakt om aangepaste codes van verschillende middelen in Joomla omvatten! module posities.
• Talen
  behalve Jumi router plugin er taal-bestanden voor alle Jumi extensies voor hun eenvoudige vertalingen.

2,1 Jumi eisen

Niets minder dan Joomla! 1.5.8 is vereist.

Upgrade van vorige versies

We raden aan om volledig verwijderen alle vorige Jumi uitbreidingen en de Jumi 2.1 pakket te installeren. Beschouw volgende:

Als u wilt uw oude Jumi component database tabel gebruiken in nieuwe Jumi 2,1 vervolgens weer it up eerst door de database tool die u gebruikt (bijv. phpMyAdmin). Na installatie van nieuwe pakket herstelt u de oorspronkelijke Jumi Component database tabel.

De oude Jumi plugin syntaxis zal niet worden verwerkt door de nieuwe plugin. U moet herschrijven om de oude plugin syntaxis aanleg. Wij zijn erg excuses voor het ongemak dat zal je. Aan de andere kant zal het u meer mogelijkheden, betere beveiliging en meer flexibiliteit. Iets voor iets.

Bedenk ook dat alle Jumi modules zullen vernietigd worden tijdens het proces van verwijderen. Dus raden we aan om een notitie van alle Jumi make modules inhoud op zijn minst.

Jumi 2.1 installatie

Installeer de verpakking als een standaard Joomla! extensie. Alle Jumi extensies zijn geïnstalleerd tijdens deze een-klik proces. Alle Jumi plugins zijn ingesteld op "Enable" ook.

In Jumi 2.1 is er geen demo hoofdmenu "Hallo Jumi!" item zichtbaar in de frontend als in Jumi 2.0. Sommige van onze gebruikers haat het zelfs als een demo. Als u wilt dat je te maken zichtbaar handmatig: ga naar de backend en bekendmaking van de voorgeïnstalleerde menu-item "Hallo Jumi!" daar.

Vervolgstappen

Met behulp van Jumi component, module en router kan worden afgeleid uit eerdere releases of documentatie of dit cheatsheet.

Jumi plugin vereist meer uitleg. Omdat het gebruik maakt van een ander hulpmiddel: Jumi editor-XTD (button) plugin dat codeert / decodeert aangepaste scripts op een wijze die zij niet verwijderd uit Joomla! en worden verwerkt door Jumi plugin.

In de rest van het artikel zullen we uitleggen:

1. Hoe codes schrijven in de Joomla! inhoud met Jumi Coder (code naam voor Jumi editor-XTD plugin).
2. Hoe te bewerken codes in Joomla! inhoud met Jumi coder.
3. Hoe overdracht oude Jumi plugin syntaxis naar de nieuwe.
4. Jumi plugin beveiliging en andere opmerkingen.

Gebruik Jumi coder

Nou, zie de video eerst. We zullen uitleggen daarna.

Dus hoe het werkt?

Je weet wanneer je onder andere voor aangepaste script in een Joomla! artikel van de code wordt verwijderd uit of, op de beste, gecodeerd in html entiteiten.

En hier komt Jumi coder. Het codeert scripts op een zodanige wijze dat Joomla! en haar uitgever niet herkent het is een code. Maar Jumi plugin herkennen Jumi syntaxis en alles tussen Jumi tags.

  Jumi stored_code_source () dit is een ruimte tussen de tags voor uw geschreven code (/ Jumi) 

decodeert en evalueert. Eenvoudig, nietwaar?

Jumi coder is getest met nowysiwyg editor, Tiny MCE, JCE en FCK redacteuren met succes. Wat is groot is dat je kunt schakelen tussen de redactie op geen enkele redacteuren als u wilt. Jumi Coder is niet afhankelijk van hen.

Dus nogmaals hoe u de code in artikel via Jumi coder? Lees en tegelijkertijd overleg met de afbeelding:

1. Schrijf (of een kopie van een bron) het script in de code-editor gebied.
   
2. Realiseer als u Wysiwyg od Nowysiwyg editor. Selecteer codering dienovereenkomstig.
3. Druk op Encode.
4. Het script is gecodeerd en je zal het gecodeerde resultaat te krijgen in de gecodeerde code gebied. (Als u een fout had gemaakt of had het script gecodeerd in voor een ander type editor, gewoon op Decode en herhalen).
5. Selecteer het script zie je in de gecodeerde code gebied, kopieert u het naar het klembord (CTRL + C) en plak (CTRL + V) in Joomla! en tussen krullend Jumi tags.

Om er zeker van zijn dat je begrijpt laten we kijken een andere video: hoe het bewerken van het script dat al in Joomla! met Jumi Coder.

We hopen dat het duidelijk genoeg.

Dus gebruik Jumi Coder voor het inbedden van het script in Joomla! en voor haar bewerking.

Jumi Coder kunnen worden gebruikt voor het inbedden van script-codes in uw niet Joomla! blog ook (zoals blogger). De code zal niet worden verwerkt, maar zal zichtbaar zijn als code.

Bekend probleem: als het script is "mooi" wordt opgemaakt (meerdere regels, tabs, etc.) dan nowysiwyg redacteur breekt deze opmaak (zonder het verlies van usability - het zal werken). I (MarHaj) weet niet hoe om te gaan.

In wysiwyg-editors mooie opmaak behouden blijft.

Het is duidelijk dat zonder Jumi plugin (geïnstalleerd en ingeschakeld) het script zelf zal niet uitgevoerd! Jumi plugin moet het eerst decoderen. Onthoud: Jumi Coder en Jumi plugin zijn tweelingen!

Syntax overzicht

De algemene Jumi 2,1 plugin syntax is

  Jumi stored_code_source () written_code (/ Jumi) 

waar

• stored_code_source is een bestand (php, css, js, txt, html, ...) padnaam te worden opgenomen in de plaats plugin syntax of id (ging met een sterretje) van Jumi component item en
• written_code is een code. HTML, PHP, JS, OT slechts een tekst. Als php code dan moet worden verpakt in PHP begin en eind-tags.
  

Voorbeelden

Voorbeeld 1: omvat enkel php bestand

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

Voorbeeld 2: met inbegrip van de eerste record uit Jumi Component database tabel

  Jumi * (1) (/ Jumi) 

Voorbeeld 3: omvat de eerste record uit Jumi Component databes tabel die wordt voorafgegaan (!) Door geschreven script.

  Jumi * (1) <? php echo 'Hello O \' Harra! ';?> (/ Jumi) 

De voorrang van de verwerking written_code -> stored_code_source heeft twee redenen:

1. het in staat stelt om een pre 2,1 Jumi php-bestanden gebruiken die gebruik maakt van Jumi argumenten met Jumi 2,1 syntaxis (we later zullen zien hoe precies),
   
2. Het is compatibel met andere Jumi extensies (component, module): ze hebben precies dezelfde behandeling kregen voorrang.
   

Meerdere lijnen in geschreven script

U moet niet schrijven geschreven script tussen Jumi tags in een lijn. Meerdere lijnen zijn toegestaan. (En combinatie van het type script gebruikt als goed). Bijvoorbeeld

  Jumi * (1) 
  <? php 
  echo 'Hello O \' Harra! '; 
  ?> 
  <div> 
  <script language="JavaScript" type="text/javascript"> 
  document.write ( "Uw favoriete drankje? <br />"); 
  thanks functie () ( 
  window.alert ( "Dank u!")) 
  </ script> 
  <form> 
  <select name="qq"> 
  <option> Water </ option> 
  <option> Melk </ option> 
  <option> Bear </ option> 
  <option> Andere </ option> 
  </ select> 
  <input type="button" value="show" onClick="thanks()"> 
  </ form> 
  <div> 
  (/ Jumi) 

Laten we nu omgaan met Jumi plugin syntaxis achteruit onverenigbaarheid.

Oude Jumi plugin syntaxis migratie

De oude - pre 2,1 Jumi - plugin is gebruik te maken van de zogenaamde Jumi argumenten concept. Het kan passeren argumenten (wat waarden) in het bestand opgenomen of opgenomen Jumi Component database record item.

In dat geval is de syntaxis, als voorbeeld, zoals deze:

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

Het argument waarden (in dit geval nummer tekst "Edo" en het nummer 888) is toegankelijk in de PHP sript (myfile.php) via $ Jumi [] array. Zoals:

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

Als uw oude PHP-scripts $ gebruikt Jumi [] array hoeft u niet prullenbak hen. Net definiëren de $ Jumi array in written_code sectie:

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

En dat is de reden waarom written_code wordt verwerkt voordat de code opgeslagen.

We hopen dat het duidelijk is en dit zal in staat te stellen uw oude scripts te migreren naar 2.1 plugin syntax gemakkelijk.

Als je schrijft de scripts van de kras kunt definiëren in written_code alle variabelen die u kunt gebruiken in stored_code_source. Bijvoorbeeld

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

Onthoud: elke variabele definieer je buiten functie of klasse wordt globale variabele. Het is zowel goed als slecht.

Het is goed omdat de variabele toegankelijk is vanaf elke locatie. Het is slecht omdat het kan interract met de variabele met dezelfde naam die is gedefinieerd (door een andere ontwikkelaar) in een andere plaats van Joomla! pagina.

Dus als u uw eigen globale variabelen geef ze nogal exotische namen.

Nieuwe Jumi plugin veiligheidsvraagstukken

Als u Joomla! als een open omgeving, dat betekent dat er veel mensen die kunnen bijdragen aan de inhoud, de veiligheid kregen hun waarden.

Laten we aannemen voor een moment is er een hij of zij iemand die wil schaden of winst maken voor zijn eigen. Als de kerel is ingeschakeld om de scripts in uw website vrij en de scripts zal echt worden verwerkt u niet in staat zijn om de man van de totale controle van uw website te voorkomen nemen. Niet erg enoyable idee, isnt 'it?

De oude Jumi bevat alleen scripts op een bestand of uit een database. De indringer kon gebruiken alleen wat zijn in uw site (en hij / zij moet weten wat de locatie). Maar nu, als directe script integratie is mogelijk? Het is een taart!

Joomla! ontwikkelaars hebben ingevoerd blacklist en whitelist filtering begrip in Joomla! 1.5.8. U kunt voorkomen dat degenen die op de zwarte lijst of niet op de whitelist van het doen van bepaalde "dingen".

2.1 Jumi plugin gebruikt deze lijst. Als het artikel auteur (of groep waartoe behoort) is in de zwarte lijst of is niet op de whitelist dan Jumi plugin zal niet verwerkt de code (direct geschreven of opgenomen van een bestand of database) en de code zal niet zichtbaar zijn in de voorste eindigen.

Joomla! zichs strips uit de code uit artikelen. Jumi Coder die beschikbaar is voor iedereen als een redacteur knop plugin zal gecodeerde script bevatten dat Joomla! wordt niet duidelijk uit. Thye code zal er zijn. Maar zal niet worden verwerkt! Het zal niet worden verwerkt, zelfs na Jumi plugin is verwijderd - het script is gecodeerd wij herhalen.

Dus als uw whitelist / blacklist goed is ingesteld, wees niet bang. Wees voorzichtig.

Parameter "Jumi Default absolute padnaam" als je het weet opzichte van vorige versies is er nog steeds. Nu zijn we met heel andere naam voor het: Jumi Root.

Jumi Root parameter maakt de toegang tot script bestanden gemakkelijk withoyt het schrijven van het volledige pad naar hen over en ouder. U kunt uw script bestanden buiten Joomla! root directory ook.

Jumi Root is eerder ingesteld onafhankelijk door iedere Jumi extensie. Nu is er slechts een plek waar je kunt het opzetten: Jumi plugin. De setup is geldig voor alle Jumi verlenging.

Dus dat is alles voor nu

Wij, ontwikkelaars, zal Edo een me (MarHaj), erkent elke feedback van u, Jumi gebruikers. Over Jumi zelf of deze documentatie. Iets ontbreekt? Iets onduidelijk? Iets werkt niet zoals verwacht?

Bedankt voor uw tijd in een voorschot!

Jumi (prefarably positief) feedbacks

Everything else