Jumi för J! 1,0 användning

Lĺt oss anta att du har jumi komponent, och plugin-modul installerad och igĺng pĺ din arbetsförmĺga Joomla! miljö.

Du kan börja spela med jumi nu.

Jag har inte rĺd att leka med jumi pĺ din allmänna aktiva webbplatsen - Du borde publicera det bara sĺ jumi program som testades framgĺngsrikt pĺ din privata (dvs. inte för allmänhetens ögon) Joomla! installation, helst pĺ den lokala datorn.

Allmän strategi att använda jumi

Bara för att pĺminna er:

Jumi ingenting men innefattar (sprutar) din egen kod i Joomla!. Antingen som en separat sida (via jumi komponent) eller i artiklar (via jumi plugin) eller i moduler läge (via jumi modul). Innehĺllet i din integration - enkelt eller magi - gör vad du ser.

Koden kan lagras i filer pĺ din server eller i ett register över jumi komponent databastabell eller direkt skrivas in jumi förlängningar.

Om du väljer att lagra dina koder i php-filer läser Säkerhetsfrĺgor ocksĺ.

Allmänna jumi används kan avsättas frĺn följande schema

I den här artikeln lär du dig hur du använder jumi komponent, plugg och en modul respektive

Komponent

Den jumi komponent skapar anpassade Joomla! sida och omfattar i den anpassad kod. Anpassad kod kan direkt skrivas in i komponenten objektet och / eller är "tillbaka" frĺn en tidigare lagrad fil.

Komponenten är tillgänglig via admin backend menyn: Komponenter -> jumi. Den öppnar jumi Application Manager.

Du kommer att se listan av komponenter program i Application Manager. Innebörden av de colums i listan och ĺtföljs Application Manager-menyn är uppenbart - det respekterar allmän Joomla! standarder.

Det finns tvĺ förinstallerade exempel där: "Hej jumi!" och "Blogspot". Frĺn dessa exempel fĺr du lära dig hur du använder jumi komponent.

Det Sökväg omrĺdet bör innehĺlla referenser till de filer som finns pĺ din server bara.

Scripts orderhantering

Om du har fyllt bĺde komponent filelds "Custom script" och "Sökväg" och sedan pĺ "Custom script" behandlas först.

Calling jumi ansökan

Du kan ringa ett program pĺ tvĺ sätt:

• avser en ansökan objekt med Joomla! menyalternativ eller. Efter installationen av komponenten finns, som ett exempel för studier, "Hello jumi!" Huvudmeny objekt anslutna till "Hello jumi!" Application objekt.
• skriva var som helst i Joomla! innehĺll länk till Application objektet URL-adress. Regeln för länken skapande är enkel:
  index.php? option = com_jumi & fileid = xxx
  där xxx är ID jumi ansökan, som kan ses i den högra kolumnen i jumi Application Manager lista.

Plugin / mambot

Den jumi plugin / mambot ingĺr i Joomla! artiklar eget skript: frĺn en fil eller frĺn jumi komponent databas rekord.

Innan du använder plugin inte glömma att aktivera det i admin backend.

Det finns en switch "Stopp / Rensa jumi koder" i plugin Advance parametrar. Om bytte till Ja det klarnar allt jumi text plugin syntax i Joomla! artiklar och hĺllplatser kod införanden!

Plugin syntax

Allmänna jumi plugin syntax kan dras av jumi Usage lathund. Vi kommer att bara nĺgra exempel här:

  (jumi [images / koder / test.php]) / / includes test.php fil i images / koder 
  (jumi [* 1]) / / includes kod lagrad i 1: a register över jumi komponent databastabell 
  (jumi omrĺde calc [test.php] bredd [4] höjd [6]) / / includes test.php fil och fyller $ jumi array 

Frĺn gett exempel kan du lätt gissa att

1. Det fĺr inte finnas nĺgra tecken mellan vänster hakparentes (och nyckelordet jumi i jumi syntax.
   
2. Allt annat utanför [] parentes är strippad ut och inte behandlas.
3. Jumi tolkar conent den första konsolen som koden källa och försöker inkludera det. Koden källa kan vara antingen en fil eller spela in ID jumi komponent databastabell.
   
4. Början frĺn den andra fästet [] jumi lagrar innehĺllet i fästena till $ jumi array. The $ jumi array (och värden) är tillgänglig frĺn ditt ingĺr PHP-kod.

Argument värden kan vara tal, vanlig text, HTML kodad text, etc. etc. Det kan vara allt med undantag av parenteser symboler: [,], (,).

Om nĺgot gĺr fel, till exempel ingenting visas i artikeln, switch "Debugläge" till Ja. Det kommer att visa dig jumi felmeddelande om detta.

Parameter: jumi Standard absoluta sökvägen

Default absoluta jumi sökväg prepanded till filen sökväg som skall ingĺ. Om inte som det är eqaul till Joomla! rotkatalog. Exempel:

Om vi skriver

  (jumi [test.php]) 

och Standard Absolute jumi Sökväg är inte satt sĺ jumi plugin slĺr upp test.php i Joomla! root (där Joomla! configuration.php är). Men om vi sätter det vara "images / mycodes" Det ser upp i den här katalogen.

Vi kan placera vĺra filer utanför Joomla! installationskatalog ocksĺ. Till exempel (om lokal värd) vi kan ha vĺra Joomla! här: "D: / xamp / htdocs / joomla". Inga problem att lagra vĺra koder här: "D: / xampp / htdocs / koder" - av Joomla! installationskatalog. Detsamma gäller för värd för webbplatser.

Default Absolute jumi Paths har fĺtt tvĺ skäl:

1. user Bekvämlighet: inget behov av att om och om igen skriva hela relativ sökväg till filer som ska ingĺ
2. Web Security: om vissa grunder jumi fungerar inte i den jumi syntaxen koden är synlig för besökare. Inklusive sökväg. Default Absolute jumi Path är dold och det är svĺrare att gueast frĺn synliga koden där koden faktiskt är. Och om de filer som ska ingĺ ligger utanför din webbplats (www) är det praktiskt taget omöjligt att nĺ dem frĺn webbläsare. Se Säkerhetsfrĺgor för mer information.
   

Default Absolute jumi Sökväg anger här är den globala parametern för alla jumi instancies plugin syntax hela Joomla!.

Parameter: Kapslade ersätta

Nesting funktionen tolkar jumi syntax i inkluderade koder. Exempel:

Lets har tvĺ filer: main.php och nested.php.

Filen innehĺller main.php

  <? php 
  echo "Detta är den viktigaste filen <br />"; 
  echo "(jumi [nested.php])"; 
  ?> 

och nested.php innehĺller

  <? php 
  echo "Detta är kapslade script"; 
  ?> 

Med bĺda filerna main.php och nested.php laddade upp pĺ servern vi kan skriva in artikeln

  (jumi [main.php]) 

Resultatet vi ser kan vara antingen

  Detta är den viktigaste fil 
  (jumi [nested.pgp]) 

Om switchen Kapslade ersätta är inställt pĺ Nej eller

  Detta är den viktigaste fil 
  Detta är kapslade script 

Om den är inställd pĺ Ja.

Det är uppenbart att Kapslade ersätta funktionen innebär för utvecklarna mycket intressanta möjligheter.

Det häckande funktionen fungerar i jumi plugin bara.

Den häckar Funktionen fungerar för filer och koder som lagras i jumi komponent databastabell.

Andra plugin parametrar

Om Debugläge är inställt pĺ Ja det kommer visa dig jumi felmeddelande om detta.

Om Stop / Clear jumi koder är inställd pĺ Ja det rensar alla jumi text plugin syntax i Joomla! artiklar och hĺllplatser kod införanden! Det finns ingen jumi kod och ingen kod utdata frĺn jumi plugin i Joomla! artiklar.

Modul

Den jumi modulen ingĺr i en modul position eget skript: manuellt eller frĺn en fil eller frĺn jumi komponent databas rekord.

Grundegenskaper

Det finns bara nĺgra grundläggande parametrs i modulen förvaltningen där: "Anteckningar", "Code skrivet" och "Source of code".

Anteckningsblock fungerar som ett omrĺde för dina anteckningar.

Kod som skrivits är ett omrĺde för din kod.

I fältet Källa kod kan du fĺ antingen en filepathname av den fil som ska ingĺ i en modul eller * ID jumi komponent Application objektet.

Avancerade parametrar

Jumi Default absolut sökväg har exakt samma innebörd som det har i plugin. Med en liten skillnad: Denna parameter är inte global för alla jumi moduler men det kan vara unika för varje jumi modul instans.

Debugläge har samma innebörd som det har i plugin: Om du väljer Nej dĺ jumi modulen kommer inte visa nĺgra jumi felmeddelande. Sĺ om du är i problem, till exempel ingenting visas, switch "Debugläge" till Ja.

Andra avancerade parametrar - Module Class Suffix, Aktivera Cache - är generella Joomla! parametrar som kan hittas i standard Joomla! moduler. Jag antar att deras betydelse är tydlig.

Scripts orderhantering

Om du har fyllt bĺde komponent filelds "Code skrivet" och "källa koden" och sedan "Koden skrivs" behandlas först.