Imagini - Documentație
Modulul funcționează cu imaginile atașate elemente în alte module. Modulul este format din două părți: o parte modul de lucru conectabile și în partea administrativă.
conexiune
Partea mufă - module / imagini / .inc.php fișier. Acesta dezvăluie o clasă _inc Imagini. Obiectul de clasă modul poate fi accesat prin variabila $ this -> diafan -> _images. Un exemplu este creat pe prima variabilă de apel.
matrice obține (string $ variație, întreg $ element_id, string $ module_name, string $ ELEMENT_TYPE, întreg $ SITE_ID, string $ alt, [întreg $ param_id = 0], [întreg $ count = 0], [string $ LINK_TO = '' ], [string $ tmpcode = '']) - devine imaginea atașată elementului modulului.
// afișează fișierele din șablonul modulului
// în module / magazin / opinii / fișier shop.view.id.php
foreach ($ imagini ca $ img)
echo ''
. “. ' "Height ="'. $ img # 91; „Inaltime“ # 93;
. ' "Alt ="'. $ img # 91; "Alt" # 93;. ' "Title ="'. $ img # 91; „Titlu“ # 93;. ''> '
. ' „;
>
Toate dimensiunile imaginii conținute în matrice $ img # 91; "Vs" # 93; pentru fiecare imagine fișierele arhivă în ciclul. Tastele sunt matrice dimensiunea etichetelor specificate în setările modulului.
// afișa imagini cu previzualizare tag
foreach ($ imagini ca $ img)
echo '';
>
Luați în considerare modul în care poate fi utilizat în șablonul modulului.
În setarea modulului „Internet magazin“ pentru produse în dimensiunea listei de imagine ( „Generarea de dimensiuni de imagini“) a creat trei dimensiuni ale sistemului, etichetat „mare“, „mediu“, „previzualizare“. Webmasterul a creat o dimensiune suplimentară a imaginii în interfața „Image Processing“. În setările de module, el a adăugat că mărimea și l-au întrebat tag-ul „nou“. Setările se aplică imaginea deja încărcată.
Acum, în module de card șablon produs / magazin / views / shop.view.id.php se poate aplica noua dimensiune a imaginii, după cum urmează:
// bucla prin toate imaginile încărcate
foreach ($ rezultat # 91; "Img" # 93; ca $ img)
// imprimă imaginea, marcate cu tag-ul „mediu“
echo '';
// imprimă imaginea, marcate cu tag-ul „mare“
echo '';
// imprimă imaginea, marcate cu tag-ul „nou“
echo '';
>
După cum se vede din exemplul o dimensiune a imaginii (lățime „lățime“ și „înălțime“ înălțime) sunt definite doar pentru tag-ul imaginii etichetate „mediu“. Dacă specificați aceste atribute pentru orice altă dimensiune a imaginii, imaginea va fi pur și simplu extins sau micșorat cu dimensiunea specificată a browser-ului, care ar putea duce la un afișaj distorsionat.
Este în modulul „magazin de Internet“ de pe cartela de element există un $ img variabilă # 91; „Previzualizare“ # 93;. care conține o trimitere la dimensiunea imaginii „previzualizare“, în cazul în care există în setările modulului. În acest caz, puteți adăuga în continuare producția de această dimensiune:
// în cazul în care dimensiunea definită de utilizator, Tagged „preview“
în cazul în care ($ rezultat # 91; "Preview_images" # 93;)
// bucla prin toate imaginile încărcate
foreach ($ rezultat # 91; "Img" # 93; ca $ img)
// imprimă imaginea, marcate cu tag-ul „previzualizare“
echo '';
>
>
array pregăti (întreg $ element_id, string $ module_name [= 'elementul' ELEMENT_TYPE string $], [întreg $ param_id = 0]) - Stochează elementele de date care trebuie să-și retragă imaginea atașată.
void delete (număr întreg | $ element_ids matrice, string $ MODULE_NAME, [= 'elementul' ELEMENT_TYPE string $], [întreg $ param_id = false]) - șterge imaginile atașate.
void delete_row (array $ rând) - Șterge-o singură imagine.
- $ Matrice rând: pe informațiile imagine stocată în baza de date
// obține date ID izobarezhnii = 3
$ Row = DB. query_fetch_array ( "SELECT * FROM WHERE id = 3");
// sterge imaginea
$ Acest -> diafan -> _images -> delete_row ($ row);
void delete_module (string $ module_name) - Șterge toate imaginile modulului.
- string $ module_name: numele modulului
încărcare mixtă (întreg $ element_id, string $ module_name, string $ ELEMENT_TYPE, întreg $ SITE_ID, intepatura $ tmpfile, string $ NEW_NAME [$ mâner boolean = false], [întreg $ param_id = 0], [string $ tmpcode = '' ]) - Loturile atașate imagine.
încerca
// încărca imaginea la ID-ul producător = 5 în magazin conectat la starinitse ID-ul = 3
$ Acest -> diafan -> _images -> încărcați (5. 'magazin' 'marca' 3. $ _FILES .. # 91; „Imagini“ # 93;, 'proizvoditel_oop');
>
de captură (Excepție $ e)
// un mesaj de eroare la pornire
echo $ e -> getMessage ();
>
void get_variation_image (string $ file_name, string $ module_name, matrice $ variație, întreg $ folder_num, [$ mâner boolean = false], [boolean $ after_selectarea = false]) - Folosește o variantă a imaginii.
- string $ file_name: nume de fișier
- string $ module_name: numele modulului
- matrice $ variație: versiune de date
- număr întreg $ folder_num: numărul de dosar
- boolean $ mâner: prelucrare manuală (pentru tăierea părți ale imaginii)
- boolean $ after_selectarea: tratament după o zonă de selectare manuală
// obține versiunea de date a imaginii pe care doriți să o aplicați imaginea
$ Variație = DB. query_fetch_array ( "SELECT * FROM WHERE id = 5");
// genera o copie a imaginii în suma primită
$ Acest -> diafan -> _images -> get_variation_image ( "izobrazhenie_tovara.jpg" "magazin" variație $ 0 ...);
Cum de a adăuga imagini atașate la modulul
În modulul de setare (module / modul / admin / modul.admin.config.php) și elemente ale modulului de editare de fișiere (module / modul / admin / modul.admin.php), trebuie să adăugați 'imagini':
Dimensiuni imagine


opțiuni de formare a imaginii au următoarele proprietăți:
- Nume - numele metodei de procesare a imaginii. Este folosit în toate modulele, care sunt conectate imagine.
- Folder - Numele directorului în litere latine fără spații, care vor fi încărcate imagini prelucrate pentru fiecare modul este format dosar separat.
Creați o dimensiune „mare», dosar mare. Setările modulului de „magazin“, a stabilit această opțiune pentru imaginea completă (tag-ul mare). Apoi, o imagine mai mare produs va fi stocat în userfiles / magazin / dosar mare.
Puteți defini următoarele:
- schimba în mod proporțional - scăderea proporțională din imagine. Dacă nu este bifată opțiunea „descrească în partea mai mică,“ este baza unei proporții minime, în caz contrar maximă;
Este necesar ca toate imaginile de pe site sunt de aceeași dimensiune: 300 x 100 pixeli. Unul trebuie să scadă mai întâi în mod proporțional cu imaginea, și apoi se taie la dimensiunea de 300h100. În acest caz, notați „Scăderea alături de„o imagine miniatură a fost mai mult 300h100 proporții.
Este necesar ca toate imaginile au aceeași înălțime - 100 de pixeli. Este necesar să se aplice acțiunea de a „schimba în mod proporțional,“ nu observând opțiunea „Scăderea în partea mai mică,“ Dimensiuni: 1000h100. Apoi, proporția minimă va fi întotdeauna o proporție de înălțime.
- selectați o regiune - zona de selecție mână pentru a fi decupată, puteți specifica proporția pentru a descărca lot (cum ar fi importul de mărfuri, sau când faceți clic pe „Aplicare setări pentru toate imaginile adăugate“ acțiune nu se aplică;
- taie - taie zona a imaginii în funcție de dimensiunea specificată și crestate;
- decolora - convertește imaginea la schema de culori negru-și-alb;
- suprapunem filigran - impune o imagine în funcție de locația specificată și deplasarea.
Setările de imagine sunt specificate în setările modulului, care sunt atașate la imagine. Este necesar să se definească următorii parametri ai modulului:
Utilizați imagine - vă permite activarea / dezactivarea de încărcare a imaginii.
Generarea de dimensiunea imaginii - dimensiunea setului de imagini în literele modulul „Image“ tag-ul și latini la o imagine pe site-ul. Acesta trebuie să se acorde în două dimensiuni: o previzualizare a imaginii în listă (tag-ul mediu) și imaginea completă (tag-ul mare). Parametrul este afișat dacă opțiunea este bifată „Image Utilizare“.
Afișarea imaginilor în listă - parametri acceptă valori:
- Nu (dezactivează afișarea imaginilor în listă);
- o imagine;
- arată toate imaginile.
- Nu (dezactivează afișarea imaginilor în listă);
- o imagine;
- arată toate imaginile.
Aplicarea setărilor pentru toate imaginile încărcate anterior - vă permite să converti dimensiunea imaginilor deja încărcate. Butonul este necesară în cazul în care modificați setarea pentru dimensiunea imaginii. Parametrul este afișat dacă opțiunea este bifată „Image Utilizare“.
Dimensiunea maximă a fișierelor descărcate - acest parametru indică dimensiunea maximă a fișierelor încărcate, instalate în setările gazdă. Parametrul este afișat dacă opțiunea este bifată „Image Utilizare“.
bază de date
- Opțiuni pentru încărcarea imaginii
module / imagini / admin / images.admin.php - opțiuni de editare a imaginilor generatoare;
Module / images / admin / images.admin.action.php - cereri post-procesare pentru imagini în secțiunea administrativă;
Module / images / admin / images.admin.inc.php - conectarea modulului la partea administrativă a celorlalte module;
Module / images / admin / images.admin.view.php - model de ieșire a imaginii în secțiunea administrativă;
Module / images / admin / js / images.admin.inc.config.js - conectarea modulului la setările altor module, JS-script;
Module / images / admin / js / images.admin.inc.js - conectarea modulului la partea administrativă a celorlalte module, JS-script;
Module / images / admin / js / images.admin.js - generatoare de opțiuni de editare de imagini, JS-script;
module / imagini / images.inc.php - conexiune pentru a lucra cu imagini atașate;
module / imagini / images.install.php - modul de setare;
Pentru a descărca poate fi doar o singură imagine, trebuie să adăugați la example.admin.php:
Ca și în modulul „Galerie foto“