Links
Statistik
Jumi 2,1 Guide
Vi indfører Jumi 2,1 beta for Joomla! 1.5 her. Der er så mange ændringer i denne version!
Når 2,1 beta ændringer i den endelige frigivelse og 2,0 vil være markeret som afskrives vi vil indarbejde dette dokument i standard Jumi dokumentation.
Intro
Jumi plugin syntaks har ændret sig (efter tre år) til anden. Der er ingen bagudkompatibilitet i denne syntaks, men du kan bruge alle tidligere brugerdefinerede koder og funktioner i 2,1 frigivelse (og bruge nye).
Der er ikke ændringer i plugin syntaks alene. Ændringer er andre steder. Så læse dokumentet grundigt, tak.
For dem, der er for ivrige efter at prøve nye version eller hader at læse "alt det" her er Quick & Dirty plugin syntaks ændring:
Gamle Jumi plugin syntaks
{Jumi [stored_code_source] [arg1] [arg2] ... [ArgN]}
Ny Jumi plugin syntaks
{Jumi stored_code_source} written_code {/ jumi}
Hvordan laver overgangen til Jumi 2,1 syntaks? Vi vil forklare det nedenfor. Men første ting først.
Lad os starte med nogle overordnede Jumi udvidelser forklaring så vil vi fortsætte med, hvordan du opgraderer og installere. Ved udgangen vil du få god viden om "alt det".
Det sæt Jumi udvidelser
Jumi 2,1 består af flere indbyrdes afhængige udvidelser:
- Jumi system plugin (Helt omskrevet!)
gør det muligt at medtage tilpassede koder fra flere ressourcer i Joomla! artikler, indhold og kategori beskrivelser.
Det opstiller Jumi Root for Jumi komponent og Jumi modul. Koder er forarbejdet i PDF-version af Joomla! indhold og strippet ud fra RSS. - Jumi redaktør-xtd (Ny!)
er en Joomla! redaktør knap, der gør det muligt at kode / afkode scripts for deres direkte optagelse i Joomla! indhold og videre forarbejdning af Jumi system plugin. - Jumi komponent (+ Delte Jumi Root brug)
skaber brugerdefinerede Joomla! sider (såkaldte Jumi Applications), der indeholder brugerdefineret kode. - Jumi SEF router
er et system plugin, der understøtter Jumi komponent: Det giver direkte adgang til Jumi ansøgning med det alias (fx http://www.mysite.com/hello-jumi). - Jumi modul (+ Debug mode, + Delt Jumi Root brug)
er simpelt modul, gør det muligt at medtage tilpassede koder fra flere ressourcer i Joomla! modul positioner. - Sprog
undtagen Jumi router plugin der er sprog-filer til alle Jumi udvidelser de let oversættelser.
Jumi 2,1 krav
Intet mindre end Joomla! 1.5.8 er påkrævet.
Opgradere fra tidligere versioner
Vi anbefaler helt at afinstallere alle tidligere Jumi udvidelser og installerer Jumi 2,1 pakken. Overvej følgende:
Hvis du vil bruge din gamle Jumi komponent databasetabel i nye Jumi 2,1 derefter tilbage det først op af databasen værktøj, du bruger (f.eks phpMyAdmin). Efter installation af nye pakke du gendanne den oprindelige Jumi Component database tabel.
Den gamle Jumi plugin syntaks vil ikke blive behandlet af den nye plugin. Du bliver nødt til at omskrive alle gamle plugin syntaks instans. Vi er meget beklager ulejligheden det vil bringe dig. På den anden side vil det bringe dig flere muligheder, bedre sikkerhed og mere fleksibilitet. Noget for noget.
Også huske, at alle Jumi moduler vil blive ødelagt i løbet af processen med afinstallationen. Så vi anbefaler at gøre et notat af alle Jumi moduler indhold i det mindste.
Jumi 2,1 installation
Installér pakken som en standard Joomla! forlængelse. Alle Jumi udvidelser er installeret i løbet af denne one-click proces. Alle Jumi plugins er indstillet til "Aktiver" for.
I Jumi 2,1 er der ingen demo hovedmenuen "Hello Jumi!" punkt synlig i frontend som det var i Jumi 2,0. Nogle af vores brugere hader det selv som en demo. Hvis du ønsker det, du er nødt til at gøre det synligt manuelt: "Hej Jumi" gå til backend og offentliggøre de forudinstallerede menupunktet der.
Næste skridt
Brug Jumi komponent, modul og router kan udledes af tidligere udsætninger eller dokumentation eller denne Snydeskema.
Jumi plugin kræver mere forklaring. Fordi den bruger et andet værktøj: Jumi editor-xtd (knap) plugin, der koder / afkoder brugerdefinerede scripts på en måde, de er ikke strippes ud fra Joomla! og behandles af Jumi plugin.
I resten af artiklen vil vi forklare:
- Hvordan man skriver koder i Joomla! indhold med Jumi coder (kodenavn for Jumi redaktør-xtd plugin).
- Hvordan du redigerer koder i Joomla! indhold med Jumi coder.
- Hvordan man kan overføre gamle Jumi plugin syntaks til den nye.
- Jumi plugin sikkerhed og andre bemærkninger.
Brug af Jumi coder
Nå, se videoen først. Vi vil forklare det efter denne.
Så hvordan det virker?
Du ved, når du medtage brugerdefinerede script ind i en Joomla! Artiklen koden vil man udelader eller i bedste fald kodet ind i html enheder.
Og her kommer Jumi coder. Det koder scripts på en sådan måde, at Joomla! og dets redaktør ikke kan genkende det er en kode. Men Jumi plugin anerkende Jumi syntaks og alt mellem Jumi tags.
{Jumi stored_code_source} dette er et mellemrum mellem tags til din skriftlige kode {/ jumi}
afkoder og evaluerer. Enkle, er det ikke?
Jumi coder er blevet testet med nowysiwyg redaktør, Tiny MCE, JCE og FCK redaktører succes. Hvad er stor, er, at du kan skifte mellem redaktører på ingen redaktører, som du ønsker. Jumi Coder afhænger ikke af dem.
Så endnu engang, hvordan man inkludere koden i artiklen via Jumi coder? Læs og samtidig høre billedet:
- Skriver (eller kopiere fra en kilde) scriptet i koden editor-området.
- Erkend, hvis du bruger Wysiwyg od Nowysiwyg editor. Vælg kodning i overensstemmelse hermed.
- Tryk Encode.
- Scriptet er kodet og du vil få det kodet resultat i den indkodede koden området. (Hvis du havde lavet en fejl eller havde kodet scriptet ind for en anden editor type, skal du blot trykke Decode og gentag).
- Vælg den script du kan se i kodet koden området, kopiere den til klippebordet (CTRL + C) og indsætte det (CTRL + V) i Joomla! og mellem krøllede Jumi tags.
For at være helt sikker på at du forstår lad os se en anden video: hvordan man kan redigere scriptet, der allerede er i Joomla! med Jumi Coder.
Vi håber, det er klart nok.
Så brug Jumi Coder for indlejring af scriptet ind i Joomla! og for dens redigering.
Jumi Coder kan bruges til at indbygge script-kode ind i din ikke Joomla! blog også (som blogger). Koden vil ikke blive behandlet, men vil være synlig som kode.
Kendt problem: hvis scriptet er "pænt" formateret (flere linjer, faner, osv.), så nowysiwyg redaktør bryder denne formatering (uden tabt af usability - det vil virke). I (MarHaj) ikke ved, hvordan man skal håndtere det.
I WYSIWYG editorer rart formateringen bevares.
Det er klart, at uden Jumi plugin (installeret og aktiveret) scriptet selv vil ikke køre! Jumi plugin har til at afkode det først. Husk: Jumi Coder og Jumi plugin er tvillinger!
Syntaks oversigt
Den generelle Jumi 2,1 plugin syntaks er
{Jumi stored_code_source} written_code {/ jumi}
hvor
- stored_code_source er en fil (php, css, js, txt, html, ...) at stinavnet skal indgå i det sted plugin syntaks eller id (fortsatte med stjerne), i Jumi komponent punkt og
- written_code er noget kode. Html, php, js, OT bare en tekst. Hvis php kode, så skal det være pakket ind i php start og slut tags.
Eksempler
Eksempel 1: kun indeholder php-fil
{Jumi plugin / system / jumi / jumi_demo.php} {/ jumi}
Eksempel 2: herunder den første post fra Jumi Component database tabel
{Jumi * 1} {/ jumi}
Eksempel 3: omfatter den første post fra Jumi Component databes tabel, som er Forud (!) Ved skriftlig script.
{Jumi * 1} <? Php echo "Hej O \ 'Harra';!?> {/ Jumi}
Har forrang for behandling written_code -> stored_code_source har fået to grunde:
- Det gør det muligt at udnytte allerede 2,1 Jumi php-filer, der bruger Jumi argumenter med Jumi 2,1 syntaks (vi vil se senere, hvordan netop),
- det er foreneligt med andre Jumi udvidelser (komponent, modul): de har fået nøjagtig samme behandling forrang.
Flere linjer i skriftlig script
Du behøver ikke skrive den skriftlige scriptet mellem jumi tags på én linje. Flere linier er tilladt. (Og kombinationen af script type, som anvendes såvel). For eksempel:
{Jumi * 1}
<? Php
echo 'Hej O \' Harra '!;
?>
<div>
<script language="JavaScript" type="text/javascript">
document.write ("Din yndlings drik <br />?");
funktion tak () {
window.alert ("Tak!")}
</ Script>
<form>
<vælg name="qq">
<option> Vand </ option>
<option> Mælk </ option>
<option> Bear </ option>
<option> Andre </ option>
</ Select>
<input type="button" value="show" onClick="thanks()">
</ Form>
<div>
{/ Jumi}
Lad os nu beskæftige sig med Jumi plugin syntaks tilbage uforenelighed.
Gamle Jumi plugin syntaks migration
Det gamle - pre 2,1 Jumi - plugin var at udnytte den såkaldte Jumi argumenter koncept. Det kunne passere argumenter (nogle værdier) i den inkluderede fil eller indeholdt Jumi Component databasepost element.
I denne sag syntaksen var, som et eksempel, som denne:
{Jumi [myfile.php] [edo] [888]}
Det argument værdier (i dette tilfælde antallet tekst "Edo" og nummer 888) var tilgængelige i php sript (myfile.php) via $ jumi [] array. Sådan her:
<? Php
echo $ jumi [0] $ jumi [1] '@ gmail.com'..;
?>
Hvis din gamle php scripts udnytter $ jumi [] array du behøver ikke trash dem. Nøjes med at definere $ jumi array i written_code afsnit:
{Jumi myfile.php} <php $ jumi = array ('Edo ", 888);?> {/ Jumi}
Og det er grunden til written_code er blevet behandlet inden gemt kode.
Vi håber, at det er indlysende, og dette vil gøre det muligt at migrere dine gamle scripts til 2,1 plugin syntaks nemt.
Hvis du skriver scripts fra bunden kan du definere i written_code enhver variabler, som du kan bruge i stored_code_source. For eksempel
{Jumi myfile.php}
<? Php
$ Navn = 'Edo';
$ Nummer = 888;
?>
{/ Jumi}
Husk: alle variable definerer du uden for funktion eller klasse bliver global variabel. Det er både godt og skidt.
Det er godt, fordi den variable er tilgængelig fra overalt. Det er slemt, fordi det kan interract med variable af samme navn, der er defineret (af en anden udvikler) på et andet sted af Joomla! side.
Så hvis du bruger din egen globale variabler give dem ret eksotiske navne.
Ny Jumi plugin sikkerhedsspørgsmål
Hvis du bruger Joomla! som et åbent miljø, der betyder at der er mange mennesker, der kunne bidrage til indholdet, har sikkerhedsspørgsmål fået deres værdier.
Lad os antage, for et øjeblik der er en han eller hun fyr, der ønsker at skade eller gøre resultatet for sin egen. Hvis den fyr er i stand til at medtage scripts ind på din hjemmeside frit og scripts vil være virkelig behandlet, vil du ikke være i stand til at forhindre den fyr fra total kontrol over dit websted. Ikke meget enoyable idé, isnt 'det?
Den gamle Jumi omfatter kun scripts fra en fil eller fra en database. Tyven kunne kun bruge, hvad der har været i dit sted (og han / hun skal kende den placering). Men nu, hvor direkte script integration er muligt? Det er en anden kage!
Joomla! udviklere har indført sortliste og whiteliste filtrering begreb i Joomla! 1.5.8. Du kan forhindre dem, der er på sorte liste eller ikke på whitelist at gøre visse "ting".
Jumi plugin 2,1 anvender denne liste. Hvis den Artiklen forfatter (Eller en gruppe, som tilhører) er i den sorte liste, eller er ikke på whitelist så Jumi plugin vil ikke forarbejdede koden (direkte skrevet eller medtages fra en fil eller en database) og koden vil ikke være synlig i forenden.
Joomla! itselfs strimler ud koden fra artiklerne. Jumi Coder, der er tilgængelig for alle som en redaktør knap plugin vil omfatte kodet script som Joomla! ikke vil rydde ud. Thye kode vil være der. Men vil ikke blive behandlet! Det vil ikke blive behandlet, selv efter Jumi plugin er afinstalleret - scriptet er kodet vi gentager.
Så hvis din whitelist / blacklist er indstillet korrekt, skal du ikke være affraid. Bare vær forsigtig.
Parameter "Jumi Standard Absolut sti", som du kender det fra tidligere udgivelser er der stadig. Nu er vi med en noget anden betegnelse for det: Jumi Root.
Jumi Root parameter gør det muligt at få adgang til script-filer nemt withoyt skrive den fulde sti til dem igen og igen. Du kan placere dine script-filer uden Joomla! rodmappe også.
Jumi Root var tidligere oprettes af hver af Jumi forlængelse uafhængigt. Nu er der kun ét sted, hvor du kan sætte den op: Jumi plugin. Opsætningen er gyldig for alle Jumi forlængelse.
Så det er alt for nu
Vi, udviklere, Edo en mig (MarHaj), vil anerkende nogen feedback fra dig, Jumi brugere. Om Jumi selv eller denne dokumentation. Mangler noget? Noget uklart? Noget ikke fungerer som forventet?
Tak for din tid i en forvejen!