Снимки - Документация

Модулът работи с изображения, свързани с елементи в други модули. Модулът се състои от две части: част сменяем модул и работа в административната част.

връзка

Приставката част - модули / снимки / изображения .inc.php файл. Той разкрива клас Снимки _inc. Обектът модул клас могат да бъдат достъпни чрез променливата $ на това -> diafan -> _images. Един пример е създаден на първата променлива повикване.

масив получите (низ $ вариант число $ element_id, низ $ module_name, низ $ ELEMENT_TYPE, число $ site_id, низ $ н [число $ param_id = 0], [число $ брой = 0], [низ $ LINK_TO = '' ], [низ $ tmpcode = '']) - Взима изображението прикрепен към елемент модул.

// показване на файловете в шаблона за модул
// в модули / магазин / възгледи / shop.view.id.php файл
foreach ($ изображения като $ IMG)
ехо ""
. ". "Височина =" ". $ IMG # 91; "Височина" # 93;
. "Alt =" ". $ IMG # 91; "Alt" # 93. "" Заглавие = "". $ IMG # 91; "Заглавие" # 93. ''> '
. " ";
>

Всички размери на изображението, съдържащи се в масив $ IMG на # 91; "Vs" # 93; за всяко изображение файлове архив в цикъла. ключовете на масива са с размерите на етикетите, посочени в настройките на модула.

// показване на изображения с етикет преглед
foreach ($ изображения като $ IMG)
ехо '';
>

Помислете как може да се използва в шаблона за модул.

В обстановка на модул "Интернет магазин" за продукти в размер на списъка с изображения ( "Създай размерите на изображението") е създал три измерения на системата, маркирани "голям", "средно", "преглед". Администраторът на сайта е създал допълнителен размер на изображението в интерфейса "за обработка на изображения" на. В модул настройки, той добави, че размерът и го попитах етикет "нов". Настройките се прилагат за вече качено изображение.

Сега в шаблон карта продукта модули / магазин / възгледи / shop.view.id.php той може да поиска от новия размер на изображението, както следва:

// цикъл през всички заредени изображения
foreach ($ резултат # 91; "Img" # 93; като $ IMG)
// разпечатва снимката, с надпис "средата" на маркера
ехо '';

// отпечатва изображението, маркирани с етикет "голям"
ехо '';

// отпечатва изображението, маркирани с етикет "нов"
ехо '';
>

Както се вижда от примера на размера на изображението (ширина "ширина" и "височината" на височина), са определени само за този за изображение с надпис "среден". Ако зададете тези атрибути за всеки друг размер на изображението, то просто ще бъде разширена или свил с посочените размери на браузъра, която може да доведе до изкривявания на дисплея.

Той се намира в модул "Интернет магазин" на картата артикул има променлива $ IMG # 91; "Визуализация" # 93. който съдържа позоваване на размера на изображението "преглед", ако тя съществува в настройките на модула. В този случай, все още можете да добавите изхода на този размер:

// ако дефинирани от потребителя размер, Маркирани "предварителен преглед"
ако ($ резултат # 91; "Preview_images" # 93)
// цикъл през всички заредени изображения
foreach ($ резултат # 91; "Img" # 93; като $ IMG)
// отпечатва изображението, маркирани с етикет "предварителен преглед"
ехо '';
>
>

масив подготви (число $ element_id, низ $ module_name [низ $ ELEMENT_TYPE = "елемент"], [число $ param_id = 0]) - Съхранява елементите на данните, които трябва да се оттегли приложеното изображение.

невалидни изтриете (число | масиви $ element_ids, низ $ MODULE_NAME, [низ $ ELEMENT_TYPE = 'елемент'], [число $ param_id = фалшива]) - Изтрива приложените снимки.

нищожен delete_row (масив $ ред) - Изтрива едно изображение.

  • масив $ ред: на информацията за изображението се съхранява в базата данни

// получи данни izobarezhnii ID = 3
$ Row = DB. query_fetch_array ( "SELECT * откъдето номер = 3");

// изтриете изображението
$ Това -> diafan -> _images -> delete_row ($ ред);

нищожен delete_module (низ $ module_name) - Изтрива всички изображения модул.

  • низ $ module_name: Име на модул

смесен качване (число $ element_id, низ $ module_name, низ $ ELEMENT_TYPE, число $ site_id, ужилване $ tmpfile, низ $ NEW_NAME [булева $ дръжка = фалшива], [число $ param_id = 0], [низ $ tmpcode = '' ]) - товарите приложените изображения.

опитвам
// заредете голям ID производителя = 5 в магазина свързан starinitse ID = 3
$ Това -> diafan -> _images -> качите (5. "магазин '' марка" 3. $ _FILES .. # 91; "изображения" # 93; "proizvoditel_oop ');
>
улов (Изключение $ д)
// съобщение за грешка при стартиране
ехо $ д -> GetMessage ();
>

невалидни get_variation_image (низ $ име_на_файл, низ $ module_name, масив $ вариант число $ folder_num [булева $ дръжка = фалшива], [булева $ after_selectarea = фалшива]) - Използва вариант на изображението.

  • низ $ име_файл: име на файла
  • низ $ module_name: Име на модул
  • масив $ вариация: версия на данни
  • число $ folder_num: номер на папката
  • булев $ дръжка: ръчна обработка (за рязане на части от изображението)
  • булев $ after_selectarea: лечение след употреба площ селекция

// получите версията на данните на изображението, което искате да приложите към изображението
$ Вариант = DB. query_fetch_array ( "SELECT * от където ID = 5");

// генерира копие на изображението в получената сума
$ Това -> diafan -> _images -> get_variation_image ( "izobrazhenie_tovara.jpg" "магазин" $ вариация 0 ...);

Как да добавяте изображения, свързани с модула

В модула за настройка (модули / модул / администратор / modul.admin.config.php) и елементи на модула за редактиране на файлове (модули / модул / администратор / modul.admin.php) трябва да добавите "изображения":

Размери на изображението

Снимки - Документация

Снимки - Документация

опции изображения имат следните свойства:

  • Име - името на метода за обработка на изображения. Той използва във всички модули, които са свързани изображения.
  • Folder - Името на папката с латински букви без празни места, които ще бъдат натоварени обработени изображения за всеки модул папка се формира отделно.

Създаване на размер "Голям», голяма папка. В модул за "магазин" е поставил тази опция за пълно изображение (таг голям). След това по-голямо изображение продукт ще се съхраняват в потребителските файлове / магазин / голяма папка.

Можете да определите следното:

  • промените в съотношение - пропорционално намаляване на изображението. Ако не се проверява на опцията "Намаляването на малката страна", е в основата на минимална част, в противен случай максималната;

Необходимо е, че всички изображения на сайта са със същия размер: 300 на 100 пиксела. Човек трябва първо да намали пропорционално на изображението и след това се нарязва на размера на 300h100. В този случай, обърнете внимание на "Намаляване на страна", за да умалено изображение е повече 300h100 пропорции.

Необходимо е, че всички изображения са на същата височина - 100 пиксела. Необходимо е да се прилагат мерки, за да "се променя пропорционално", не се отбележи, опция "Намаляване на малката страна," Размери: 1000h100. След това минимално съотношение винаги ще бъде част от височината.

  • изберете регион - област селекция ръка, за да бъдат отрязани, можете да укажете на дела за партида изтегляне (като внос на стоки, или когато кликнете върху "Прилагане на настройките за всички добавени снимки" действие не се прилагат;
  • нарязани - изрежете площ на изображението в зависимост от определен размер и вдлъбнатината;
  • обезцветявам - преобразува изображението в черно-бяла цветова схема;
  • насложат воден знак - налага изображение в зависимост от указаното място и преместване.

настройки на изображението са посочени в настройките на модула, които са прикрепени към изображението. Необходимо е да се определят следните параметри на модула:

Използвайте изображение - ви позволява да включите / изключите зареждането на изображения.

Генериране на размер на изображението - размерът на поредицата изображения в модул "Изображение" маркери и латинските букви от към изображение на сайта. Тя трябва да се дава в два размера: преглед на изображението в списъка (среден маркер) и снимката (таг голям). Параметърът се показва, ако опцията е отметната "Използване на изображението".

Посочете изображения в списъка - параметър приема стойности:

  • Не (забранява показването на изображения в списъка);
  • едно изображение;
  • показване на всички изображения.
  • Не (забранява показването на изображения в списъка);
  • едно изображение;
  • показване на всички изображения.

Нанесете на настройките за всички предварително качените изображения - това ви позволява да конвертирате размера на вече качените изображения. Бутонът се изисква, ако промените настройката за размер на изображението. Параметърът се показва, ако опцията е отметната "Използване на изображението".

Максималният размер на файлове за изтегляне - този параметър показва максималния размер на качените файлове, инсталирани в настройките на хост. Параметърът се показва, ако опцията е отметната "Използване на изображението".

база данни

- Възможности за качване на изображения

Модули / снимки / администратор / images.admin.php - генериране на опции за редактиране на изображения;

модули / снимки / администратор / images.admin.action.php - молби за снимки в административната част последваща обработка;

модули / снимки / администратор / images.admin.inc.php - свързване на модула до административната част на останалите модули;

модули / снимки / администратор / images.admin.view.php - фотографии на модел в административната част;

модули / снимки / администратор / JS / images.admin.inc.config.js - свързване на модула за настройките на други модули, JS-скрипт;

модули / снимки / администратор / JS / images.admin.inc.js - свързване на модула до административната част на останалите модули, JS-сценария;

модули / снимки / администратор / JS / images.admin.js - генериране на опции за редактиране на изображения, JS-скрипт;

модули / снимки / images.inc.php - връзка за работа с прикачени снимки;

модули / снимки / images.install.php - определяне на модул;

За да изтеглите може да бъде само едно изображение, което трябва да се добави към example.admin.php:


Както и в модула "Фото галерия"