Jumi 2.1 Guide
Vi introduserer Jumi 2.1 beta for Joomla! 1.5 her. Det er så mange endringer i denne versjonen!
Når 2.1 beta endringer i den endelige versjonen, og 2.0 vil bli markert som avskrives vi vil innarbeide dette dokumentet i standard Jumi dokumentasjonen.
Intro
Jumi plugin syntaks har endret seg (etter tre år) til annen. Det er ingen bakoverkompatibilitet i denne syntaksen, men du kan bruke alle tidligere egendefinerte koder og funksjoner i 2.1 release (og bruke nye).
Det er ikke endringer i plugin syntaks bare. Endringer er andre steder. Så lese dokumentet nøye, takk.
For de som er for ivrige etter å prøve nye versjonen, eller hater å lese "alt det der" her er Quick & Dirty plugin syntaks endring:
Gamle Jumi plugin syntaks
{Jumi [stored_code_source] [ARG1] [ARG2] ... [ArgN]}
Ny Jumi plugin syntaks
{Jumi stored_code_source} written_code {/ Jumi}
Hvordan gjøre overgangen til Jumi 2,1 syntaks? Vi vil forklare det nedenfor. Det første først.
La oss starte med noen generelle Jumi extensions forklaring så vi vil fortsette med hvordan å oppgradere og installere. På slutten vil du få god kunnskap om "alt det der".
Settet av Jumi utvidelser
Jumi 2.1 består av flere innbyrdes avhengige utvidelser:
- Jumi system plugin (Totally omskrevet!)
gjør det mulig å inkludere egendefinerte koder fra flere ressurser inn i Joomla! artikler, innhold og kategori beskrivelser.
Det setter opp Jumi Root for Jumi komponent og Jumi modul. Koder er behandlet i PDF-versjon av Joomla! innhold og strippet ut fra RSS. - Jumi editor-xtd (New!)
er en Joomla! editor-knapp som gjør det mulig å kode / dekode scripts for deres direkte inkludering i Joomla! innhold og videre bearbeiding av Jumi system plugin. - Jumi komponent (+ Delt Jumi Root bruk)
skaper tilpasset Joomla! sider (såkalt Jumi Applications) som inneholder egendefinert kode. - Jumi SEF router
er et system plugin som støtter Jumi komponent: Det muliggjør direkte tilgang av Jumi søknad med det alias (f.eks http://www.mysite.com/hello-jumi). - Jumi modul (+ Debug mode, + Felles Jumi Root bruk)
er enkel modul som gjør det mulig å inkludere egendefinerte koder fra flere ressurser inn i Joomla! modul posisjoner. - Språk
bortsett Jumi ruteren plugin er det språk filer for all Jumi utvidelser for sine enkle oversettelser.
Jumi 2.1 krav
Intet mindre enn Joomla! 1.5.8 er nødvendig.
Oppgradering fra tidligere versjoner
Vi anbefaler å avinstallere alle tidligere Jumi utvidelser og installere Jumi 2,1 pakken. Vurder følgende:
Hvis du ønsker å bruke den gamle Jumi komponent databasetabell i nye Jumi 2,1 deretter tilbake den opp først av databasen verktøyet du bruker (f.eks phpMyAdmin). Etter installasjon av ny pakke gjenoppretter du det opprinnelige Jumi Component database tabellen.
Den gamle Jumi plugin syntaks vil ikke bli behandlet av den nye plugin. Du må skrive alle gamle plugin syntaks forekomst. Vi er veldig lei for det inntrufne det vil ta deg. På den annen side vil det gi deg flere muligheter, bedre sikkerhet og mer fleksibilitet. Noe for noe.
Husk også at alle Jumi moduler vil bli ødelagt i løpet av prosessen med avinstallering. Så vi anbefaler å notere alt Jumi moduler innhold i det minste.
Jumi 2.1 installasjon
Installer pakken som en standard Joomla! forlengelse. Alle Jumi utvidelser er installert i løpet av denne ett klikk. Alle Jumi plugins er satt til "Enable" også.
I Jumi 2.1 er det ingen demo hovedmenyen "Hello Jumi!" elementet synlig på forsiden som det var i Jumi 2.0. Noen av våre brukere hater det selv som en demo. Hvis du vil ha den må du gjøre det synlig manuelt: "Hei Jumi" gå til backend og publisere den forhåndsinstallerte menyelementet det.
Neste skritt
Ved hjelp av Jumi komponent, modul og ruter kan utledes fra tidligere utgivelser eller dokumentasjon eller denne cheatsheet.
Jumi plugin krever mer forklaring. Fordi den bruker et annet verktøy: Jumi editor-xtd (knappen) plugin som koder / dekoder egendefinert skript på en måte de ikke er strippet ut fra Joomla! og behandles av Jumi plugin.
I resten av artikkelen vil vi forklare:
- Hvordan du skriver kodene inn i Joomla! innhold med Jumi coder (kodenavn for Jumi editor-xtd plugin).
- Hvordan redigere koder i Joomla! innhold med Jumi coder.
- Hvordan overføre gamle Jumi plugin syntaks til den nye.
- Jumi plugin sikkerhet og andre bemerkninger.
Bruke Jumi coder
Vel, se videoen først. Vi vil forklare det etter det.
Så hvordan det fungerer?
Du vet når du inkluderer egendefinerte script inn i en Joomla! artikkelen vil koden bli strippet ut eller, på den beste, kodet inn i html enheter.
Og her kommer Jumi coder. Det koder skript på en slik måte at Joomla! og dens redaktør anerkjenner ikke det er en kode. Men Jumi plugin gjenkjenne Jumi syntaks og alt mellom Jumi tags.
{Jumi stored_code_source} dette er en plass mellom koder for skriftlige koden {/ Jumi}
dekoder og evaluerer. Enkelt, ikke sant?
Jumi coder har blitt testet med nowysiwyg redaktør, Tiny MCE, JCE og FCK redaktører vellykket. Hva er bra er at du kan bytte mellom redaktører på ingen redaktører som du ønsker. Jumi Coder ikke avhengig av dem.
Så nok en gang hvordan du kan ta inn koden i artikkelen via Jumi coder? Les og samtidig se i bildet:
- Skriv (eller kopier fra noen kilde) skriptet inn koden editor området.
- Realisere dersom du bruker Wysiwyg od Nowysiwyg editor. Velg koding tilsvarende.
- Trykk Socket.
- Skriptet er kodet og du vil få kodet resultatet i den kodede koden området. (Hvis du hadde gjort en feil eller hadde kodet skriptet inn for en annen type editor, trykker du bare Dekoding og gjenta).
- Velg script du ser i kodet koden området, kopiere den til utklippstavlen (CTRL + C) og lim den (CTRL + V) i Joomla! og mellom krøllete Jumi tags.
For å være helt sikker på at du forstår la oss se på et annet video: hvordan å redigere skriptet som allerede er i Joomla! med Jumi Coder.
Vi håper det er klart nok.
Så bruk Jumi Coder for innebygging skriptet inn Joomla! og for å redigere de.
Jumi Coder kan brukes for innebygging script koder inn din ikke Joomla! bloggen også (som blogger). Koden vil ikke bli behandlet, men vil være synlig som kode.
Kjent problem: hvis skriptet er "pent" formatert (flere linjer, faner, osv.) så er nowysiwyg redaktør bryter denne formateringen (uten mistet brukervennlighet - det vil fungere). I (MarHaj) vet ikke hvordan man skal håndtere det.
I wysiwyg redaktører fint formatering er bevart.
Det er klart at uten Jumi plugin (installert og aktivert) skriptet i seg selv vil ikke kjøre! Jumi plugin har å dekode det første. Husk: Jumi Coder og Jumi plugin er tvillinger!
Syntax oversikt
Den generelle Jumi 2,1 plugin syntaks er
{Jumi stored_code_source} written_code {/ Jumi}
der
- stored_code_source er en fil (php, css, js, txt, html, ...) til veinavn skal inkluderes i stedet plugin syntaks eller id (fortsatte med stjerne) av Jumi komponent element og
- written_code er noe kode. Html, php, js, ot bare en tekst. Hvis php koden så den må være pakket inn i php start og slutt koder.
Eksempler
Eksempel 1: bare omfatter php fil
{Jumi plugin / system / Jumi / jumi_demo.php} {/ Jumi}
Eksempel 2: inkludert den første posten fra Jumi Component database tabell
{Jumi * 1} {/ Jumi}
Eksempel 3: inkluderer den første posten fra Jumi Component databes bord som er innledes (!) Ved skriftlig script.
{Jumi * 1} <? Php echo "Hei O \ 'Harra';!?> {/ Jumi}
Rekkefølgen av behandlingen written_code -> stored_code_source har fått to grunner:
- den gjør det mulig å utnytte pre 2,1 Jumi php-filer som bruker Jumi argumenter med Jumi 2,1 syntaks (vi vil se senere hvordan akkurat),
- den er kompatibel med andre Jumi utvidelser (komponent, modul): de har fått nøyaktig samme behandling forrang.
Flere linjer i skriftlig script
Du trenger ikke skrive den skriftlige manuset mellom Jumi tagger i én linje. Flere linjer er tillatt. (Og kombinasjon av script type som brukes i tillegg). For eksempel:
{Jumi * 1}
<? Php
echo 'Hei O \' Harra '!;
?>
<div>
<script language="JavaScript" type="text/javascript">
document.write ("Din favoritt drikk <br />?");
funksjon takk () {
window.alert ("Takk!")}
</ Script>
<FORM>
<select name="qq">
<alternativ> Vann </ option>
<alternativ> Milk </ option>
<alternativ> Bear </ option>
<alternativ> Andre </ option>
</ Select>
<input type="button" value="show" onClick="thanks()">
</ Form>
<div>
{/ Jumi}
Nå la oss håndtere Jumi plugin syntaks bakover uforlikelighet.
Gamle Jumi plugin syntaks migrasjon
Den gamle - pre 2,1 Jumi - plugg var å utnytte den såkalte Jumi argumenter konsept. Det kunne passere argumenter (noen verdier) i den medfølgende filen eller inkludert Jumi Component database posten element.
I så fall syntaksen ble, som et eksempel, som denne:
{Jumi [myfile.php] [edo] [888]}
Argumentet verdier (i dette tilfellet antallet teksten "edo" og nummer 888) ble tilgjengelig i php sript (myfile.php) via $ Jumi [] array. Som dette:
<? Php
echo $ Jumi [0] $ Jumi [1] "@ gmail.com"..;
?>
Hvis den gamle php-skript bruker $ Jumi [] array du trenger ikke søppel dem. Bare definere $ Jumi array i written_code avsnitt:
{Jumi myfile.php} <php $ Jumi = array ('edo', 888);??> {/ Jumi}
Og det er derfor written_code blir behandlet før koden er lagret.
Vi håper det er klart, og dette vil gjøre det mulig å overføre gamle skriptene inn 2,1 plugin syntaks lett.
Hvis du skriver skript fra scratch du kan definere i written_code noen variabler som du kan bruke i stored_code_source. For eksempel
{Jumi myfile.php}
<? Php
$ Name = 'Edo';
$ Antall = 888;
?>
{/ Jumi}
Husk: alle variabler du definerer utenfor funksjonen eller klassen blir global variabel. Det er både gode og dårlige.
Det er bra fordi variabelen er tilgjengelig fra hvor som helst. Det er dårlig fordi det kan interract med variable med samme navn som er definert (av en annen utvikler) på et annet sted av Joomla! side.
Så hvis du bruker din egen globale variabler gi dem ganske eksotisk navn.
Ny Jumi plugin sikkerhetsspørsmål
Hvis du bruker Joomla! som et åpent miljø, det betyr at det er mange mennesker som kunne bidra til innholdet, har den sikkerhetsspørsmål fikk sine verdier.
La oss anta et øyeblikk det er en han eller hun fyr som ønsker å skade eller gjøre profitt for sine egne. Hvis fyren er aktivert å inkludere skript på nettstedet ditt fritt og skript vil bli virkelig behandlet vil du ikke kunne hindre at fyren fra total kontroll over ditt nettsted. Ikke veldig enoyable idé, isnt 'den?
Den gamle Jumi omfatter bare skript fra en fil eller fra en database. Inntrengeren kunne bruke bare det som har vært på din side (og han / hun må kjenne stedet). Men nå, når direkte script inkludering er mulig? Det er en annen kake!
Joomla! utviklere har innført svarteliste og hviteliste filtrering konseptet til Joomla! 1.5.8. Du kan forhindre at de som er på svarteliste eller ikke på hvitliste fra å gjøre visse "ting".
Jumi plugin 2.1 bruker denne listen. Dersom artikkelforfatteren (Eller gruppe som tilhører) er i svarteliste eller ikke er på hvitliste da Jumi plugin vil ikke behandlet koden (direkte skrevet eller tatt fra en fil eller database) og koden vil ikke være synlig i fronten.
Joomla! itselfs strimler ut koden fra artiklene. Jumi Coder som er tilgjengelig for alle som redaktør knapp plugin vil omfatte kodet script som Joomla! ikke vil slette ut. Thye koden vil være der. Men vil ikke bli behandlet! Det vil ikke bli behandlet selv etter Jumi plugin er avinstallert - manuset er kodet vi gjenta.
Så hvis du hviteliste / svarteliste er satt riktig, ikke vær affraid. Bare vær forsiktig.
Parameter "Jumi Default Absolute Sti" som du kjenner det fra tidligere versjoner er der fortsatt. Nå er vi bruker ganske annet navn på det: Jumi Root.
Jumi Root parameteren gjør tilgang til script filer enkelt withoyt skrive den fullstendige banen til dem om og om igjen. Du kan plassere din script filer utenfor Joomla! rotkatalogen også.
Jumi Root ble tidligere satt opp av hver Jumi forlengelse uavhengig. Nå er det bare ett sted hvor du kan sette det opp: Jumi plugin. Oppsettet er gyldig for alle Jumi forlengelse.
Så det er alt for nå
Vi, utviklere, Edo en meg (MarHaj), vil erkjenne noen tilbakemelding fra deg, Jumi brukere. Om Jumi selv eller denne dokumentasjonen. Noe mangler? Noe uklart? Noe ikke fungerer som forventet?
Takk for din tid i et forskudd!

