Модуль створений для модернізації стандартної функцію двигуна DLE. Він змінює стандартні перехресні посилання у додаткове поле.
За допомогою модуля, можна сотворити окрему сторінку, куди будуть виведені усі публікації з окремого додаткового поля з ввімкненою функцією перехресних посилань.
Наприклад у вас є додаткове поле «Models» у яке ви вписуєте прізвища та ім’я актрис з фільму.
Встановивши і налаштувавши модуля ви отримайте сторінку «models» на якій будуть виведені усі моделі які ви додали у своє додаткове поле «Models».
Модуль можна використовувати для необмеженою кількості додаткових полів. Наприклад додатково ви можете створити окремі сторінки для «Студій», «Акторів», «Актрис», «Років», «Режисерів»…
Модуль «DLE Cross References v1.2» має дуже багато налаштувань, які прописуються для кожного додаткового поля окремо. Крім того модуль інтегрований з DLE і частину налаштувань він отримує саме з DLE.
Якщо у DLE ввімкнене кешування, то і модуль буде кешувати сторінки. Рекомендую обов’язково вмикати кешування, це значно зменшить навантаження на сервер і час завантаження сторінок модуля.
Крім того, якщо у налаштуваннях DLE у вас ввімкнута «Відкладене завантаження зображень» то ці налаштування буде використовуватися для постерів у модулі.
PHP – 5.4 – 8.0 (Скоріш за все і в більш високих версіях буде працювати)
DLE – 13.0 - 16.2
ЛЗУ – Завжди використовує, навіть якщо вимкнені у налаштуваннях DLE (Обов’язково потрібні налаштування Apache/NGINX)
10$ – За сам архив модуля і інструкцію зі встановлення (цю), кількість доменів не обмежується. Але модуль можна використовувати лише на сайтах що належать покупцеві. Модуль забороняється перепродавати, міняти чи передавати третім особам.
5$ – За встановлення модулю на один домен і налаштування стилей під нього.
Окремо можна придбати паки з постерами.
У потрібному файлі і місці вашого шаблону .tpl вставте код виводу модулю, для додаткового поля. Рекомендую main.tpl
Це код лише з обов’язковими параметрами:
[available=EEE]{include file="engine/modules/lexxs_tags.php?xf_name=XXX&xf_sorting=low_tagvalue&xf_picking=ASC"}[/available]
Значення які треба обов’язково налаштовувати, видалені жирним
Це код з усіма можливими функціями і налаштуваннями:
[available=EEE]{include file="engine/modules/lexxs_tags.php?xf_name=XXX&xf_new_name=WWW&xf_sorting=low_tagvalue&xf_picking=ASC&xf_navigation=yes&xf_navigation_number=KK&xf_alphabet=yes&xf_amount=yes&xf_number=24&xf_img=yes&xf_format_img=RRR&xf_alt_img=TTT&xf_img_url=LLL&xf_titleErrors=ERR&xf_textErrors=ERT&xf_myalphabet=SSS&xf_nophotonolinks=yes&xf_domain=https://AAA"}[/available]
Знаячення які можна/треба налаштовувати, виділені жирним
XXX - Назва додаткового поля на латиниці для якого ви робите вивід у шаблоні (Обов’язковий параметр)
EEE - Назва додаткового поля на латиниці для якого ви робите вивід у шаблоні (Обов’язковий параметр)
24 - Кількість публікацій на одну сторінку (Працює тільки разом з параметром «xf_navigation=yes»)
KK - Значення для максимальної кількості сторінок пагінації. (Працює тільки разом з параметром «xf_navigation=yes»)
WWW - Альтернативна назва для вашого додаткового поля. Дає можливість змінити назву сторінки, не змінюючи додаткове поле (Якщо використовуєте цей параметр, то треба дати таке саме значення і для «EEE»). Параметр міняє назву доп поля, лише для функцій самого модуля.
RRR - Вказується формат зображення на сервері для постерів у модулі (приклад: jpg | png) (Працює тільки разом з «xf_img=yes»).
TTT - Свій початковий текст для «alt» постерів у модулі (Працює тільки разом з «xf_img=yes»).
ERR - Свій текст для блока помилки, який з’являється якщо для вибраної літери, немає жодної публікації (Працює тільки разом з параметром «xf_alphabet=yes»).
ERT - Свій текст, для блоку помилки, який з’являється якщо для вибраної літери, немає жодної публікації (Працює тільки разом з параметром «xf_alphabet=yes»).
SSS - Вивід абетки, може приймати значення "ua", "ru", "S, S, S.." де "S" це ваш набор необхідних символів, через кому (Працює тільки разом з параметром «xf_alphabet=yes»).
YYY - Значення перехресного посилання.
LLL - Вибір функції для перевірки наявності фото.
Як бачите, параметрів які можна налаштовувати, дуже багато.
Але як ви бачите, у списку вище, немає багатьох параметрів, які присутні у модулі.
Нижче повній список усіх параетрів які можуть використовуватись і докладно про кожен з них і їх можливі значення..
Увага!!! Усі параметри між собою розділяються символом &, потим йде сама назва параметра, виглядає як xf_параметр, потім знак = і далі саме значення параметра.
Якщо ви використовуєте Apache для сайта, вам треба скопіювати наступний код і вставити його у кореневий .htaccess до RewriteCond %{REQUEST_FILENAME} !-d.
RewriteRule ^XXX(/?)+$ index.php?do=XXX [L]
RewriteRule ^XXX/page/([0-9]+)(/?)+$ index.php?do=XXX&page=$1 [L]
RewriteRule ^XXX/([^/]*)(/?)+$ /index.php?do=XXX&letter=$1 [L]
RewriteRule ^XXX/([^/]*)/page/([0-9]+)(/?)+$ /index.php?do=XXX&letter=$1&page=$2 [L]
Якщо ви використовуєте NGINX для сайта, вам треба скопіювати наступний код і вставити його у потрібне місце налаштувань NGINX. (На різних панельях, версіях ПО і просто налаштувань, це може бути різне місце. Якщо ви використовуєте NGINX, то повинні знати де і як у вас треба робити).
rewrite "^/XXX(/?)+$" /index.php?do=XXX last;
rewrite "^/XXX/page/([0-9]+)(/?)+$" /index.php?do=XXX&page=$1 last;
rewrite "^/XXX/([^/]*)(/?)+$" /index.php?do=XXX&letter=$1 last;
rewrite "^/XXX/([^/]*)/page/([0-9]+)(/?)+$" /index.php?do=XXX&letter=$1&page=$2 last;
Увага!!! У коді висче треба замінити усі XXX, на назву вашого додаткового поля, або на Альтернативну назву, що ви водили замість WWW.
Увага!!! Даний код треба додавати, для кожного нового додаткового поля, що ви хочете використовувати через модуль. У кожному коді змінюєте XXX на данні нового додаткового поля.
У стилі вашого шаблона, додати код:
.page-tags{overflow:hidden;text-align:center;display:-ms-grid;display:grid;justify-items:center;-ms-grid-columns:1fr 1fr 1fr 1fr 1fr 1fr;grid-template-columns:1fr 1fr 1fr 1fr 1fr 1fr;grid-column-gap:10px;grid-row-gap:21px}
.page-tags > a{color:#fff;background:#26313C;display:inline-block;padding:5px 10px;box-sizing:border-box;text-decoration:none;width:100%;white-space:pre;-o-text-overflow:ellipsis;text-overflow:ellipsis;overflow:hidden}
.page-tags > a:hover{background:#555}
.page-tags > a span{margin-left:5px}
.page-tags .img{position:relative;background:#919191;line-height:0;overflow:hidden;width:100%;height:0;padding-bottom:135%;margin-bottom:5px}
.page-tags img{position:absolute;display:block;width:100%;height:100%;border:0;object-fit:cover;object-position:top}
.page-tags.studios{padding-bottom:100%}
.navigation{margin:25px 0;text-align:center}
.navigation a,.navigation span,.alphabet-switcher a,.alphabet-switcher span{display:inline-block;padding:8px 16px;margin:4px 2px;text-decoration:none;color:#fff;background:#1f7ab5}
.navigation span{cursor:not-allowed}
.navigation a:hover,.alphabet-switcher a:hover{background:#BA2716}
.navigation div{display:inline-block}
.alphabet-switcher{text-align:center;margin-bottom:15px}
.navigation span.active,.alphabet-switcher span.active{background:#BA2716}
.navigation a:hover,.alphabet-switcher a:hover{background:#BA2716}
.message-info{color:#5c5c5c;line-height:1.5;margin-bottom:20px;background-color:#FFF3E0;box-shadow:0 1px 3px rgba(0,0,0,.12),0 1px 2px rgba(0,0,0,.24);border:1px solid #FF9800;border-left-width:1px;position:relative;padding:15px 20px;border-left-width:44px}
.message-info::before{font-family:'Font Awesome 5 Pro';font-weight:300;font-size:22px;color:#fff;margin-top:-18px;position:absolute;left:-44px;top:50%;width:44px;text-align:center}
@media only screen and (max-width:991px) {
.page-tags{-ms-grid-columns:1fr 1fr 1fr 1fr;grid-template-columns:1fr 1fr 1fr 1fr}
}
@media only screen and (max-width:767px) {
.page-tags{-ms-grid-columns:1fr 1fr 1fr;grid-template-columns:1fr 1fr 1fr}
}
@media only screen and (max-width:500px) {
.page-tags{-ms-grid-columns:1fr 1fr;grid-template-columns:1fr 1fr}
}
Увага!!! Код створений як приклад і може не коректна працювати на вашому шаблоні. Його треба підгоняти під кожний шаблон і потреби окремо.
Встановлення модуля «DLE Cross References» v1.2 і його налаштування під одне додаткове поле закінчено.
Сторінка з модулем для вказаного додаткового поля буде доступна по адресі: Домен/EEE/
[available=EEE] - Стандартний тег DLE, їм обрамляється код модуля, для того щоб він виводився лише на потрібній сторінці сайту. Замість EEE, треба вписати або назву додаткового поля яке ви прописали у XXX, або альтернативну назву яку ви дали свому доп полю у WWW
xf_name=XXX - Параметр у якій водиться назва додаткового поля з якого ви хочете формувати сторінку з усіма перехресними посилання, веденими у нього. Замість XXX, треба вписати назву додаткового поля з якого треба брати інфорацію (Обов’язковий параметр)
xf_new_name=WWW - Параметр яким ви можете змінити назву сторінки для вашого додаткового поля. Взагалі модуль використовує назву додаткового поля для пагінації та папки для постерів на сервері.
Прописавши замість «WWW» своє значення, модуль почне використовувати його для шляхів у пагінації, та для пошуку зображення на сервері.
Даний параметр, дуже знадобиться якщо у вас не дуже гарна назва у додатковому полі і сайт не новий (немає змоги створити додаткове поле з потрібною назвою). Якщо ви на робочому сайті зминете назву у додаткового поля, то усіх новинах усі значення які були ведені пропадуть. Якщо без використання параметра «xf_new_name», то треба правити БД сайта, але при цьому усі старі посилання змінять посилання.
xf_sorting=low_tagvalue - Змінивши значення цього параметра, ви можете змінити сортування публікацій за абеткою, чи за кількістю публікацій. Параметр може приймати лише два значення. low_tagvalue – за абеткою або count – по кількості. (Обов’язковий параметр)
Увага!!! Значення count буде працювати лише з увімкненим підрахунком кількості однакових перехресних посилань (параметром "xf_amount=yes")
xf_picking=ASC - Змінивши параметр цієї функції, ви можете змінити сортування за зростанням чи спаданню. Параметр має лише два значення ASC – Від A до Z (А до Я) та DESC від Z до A (Я до А) (Обов’язковий параметр)
xf_img=yes - Параметр який має лише одне значення yes, цей параметр треба прописати якщо ви хочете виводити постер для значень ваших перехресних полів (Для кожної актриси).
Якщо картинки до перехресного посилання немає, то буде завантажена фото заглушка, яка має назву no-foto.webp
Самі постери треба завантажувати у "/uploads/cross_references/XXX/YYY.RRR" де:
XXX це назва вашого додаткового поля або це WWW якщо ви використали альтернативну назву для додаткового поля у модулі.
YYY це значення вашого перехресного посилання (прізвище та ім’я актриси). Усі назви для постера треба робити у ніжному регістрі и замість пробіла або кількох пробілів поспіль, ставити тире «-», так само і замість нижнего підкреслення «_» ставити тире «-».
RRR це льтернативне розширення для постерів, якщо ви використовуєте параметр для цього.
Стандартно, розмір зображення повинен бути 200px х 300px, але тут усе залежить від шаблону сайту.
Для кожного додаткового поля, требо створити свою папку. При встановлені модулю створюються лише папки «models» та «studios».
Приклад, якщо ваше додаткове поле називатися «models» а значення перехрестного посилання «Alina Ferdis», то постер буде мати такий шлях і ім’я: "/uploads/cross_references/models/alina-ferdis.webp"
Увага!!! Використання даного параметра, збільшить складність запитів до БД сайта, чим збільшить навантаження на сервер і час створення сторінки.
xf_format_img=RRR - Параметр яким можна змінити формат зображення яке шукає модуль на сервері. Стандартно модуль шукає webp, але якщо вам потрібне будь який інший формат, ви його можете задати тут по прикладу: «jpg», «png»…
Працює лише разом з увімкненими постерами (параметром "xf_img=yes")
Увага!!! Не забрудьте додати свій постер заглушку з ім’я «no-foto.RRR» де замість RRR формат який ви прописали як значення параметра.
xf_alt_img=TTT - Параметр який дає можливість додати свій текст у alt постера перехресного посилання. Якщо не додавати даний параметр, то постер буде мати у alt лише значення додаткового поля (ім’я моделі). Якщо у параметрі замість TTT вказати своє значення, то буде: «ваше значення» «ім’я актриси»
Працює лише разом з увімкненими постерами (параметром "xf_img=yes")
xf_img_url=LLL - Параметр має два значення, це «fast» та «stable». Якщо не додавати данний параметр, буде використовуватися «fast».
fast – Використовує функцію get_headers() перевіряє наявність фото за статусом HTTP-запиту до фото. Без фактичного завантаження вмісту посілання. Але на деяких серверах може не працювати – бути вимкненим.
stable – Фактично завантажує вміст посилання, чим перевіряє наявність фото. Працює на усіх серверах.
Працює лише разом з увімкненими постерами (параметром "xf_img=yes")
xf_nophotonolinks=yes - Параметр має лише одне значення yes, цей параметр треба прописати якщо ви хочете виводити лише перехрестні поля які мають зображення
Має сенс використання лише з увімкненими постерами (параметром "xf_img=yes")
Увага!!! Для того щоб працював даний параметр, треба:
1. Завантажити фото для перехресного поля у потрібну теку.
2. зайти у админку модуля (сюди: https://domen/admin.php?mod=lexxs_tags)
3. Вибрати потрібне додаткове поле (для якого ви робите робите вивід лише з фото, вибрати формат зображень і вписати альтернативну назву «WWW» для вашого додаткового поля – тільки якщо задавали його у підключенні модуля)
4. Натиснути кнопку «Почати обробку» і дочекатися поки не закінчиться процес обробки.
Ця дія, перевірить для кожного перехресного поля доступність фото и проставить результат у БД.Цю дію треба повторювати час від часу (якщо додали нові фото, або додали багато нових моделей для яких є фото) інакше вони не з’являться на сайті.
xf_navigation=yes - Параметр який має лише одне значення yes, цей параметр треба прописати якщо ви хочете розбити сторінку на багато сторінок (додати пагінацію). За замовчення на сторінці буде виводитися 10 сторінок пагініції).
Увага!!! Використання даного параметра, збільшить складність запитів до БД сайта, чим збільшить навантаження на сервер і час створення сторінки. Але зменшить кількість коду на одній сторінці, чи облегшить створення сторінки браузером (при великій кількості матеріалів, браузер може зависнути, упершись у ліміт самого браузера).
xf_number=24 - Ви можете змінити кількість перехресних посилань на сторінку. Для цього просто впишіть своє значення для параметра замість 24
Працює лише разом з пагінацією (параметром "xf_navigation=yes")
xf_navigation_number=KK - Ви можете змінити максимальну кількість сторінок пагінації, що можуть виводитись одночасно (Стандартне значення 10.). Для цього просто впишіть своє значення для параметра замість KK
Працює лише разом з пагінацією (параметром "xf_navigation=yes")
xf_amount=yes - Параметр який має лише одне значення yes, цей параметр треба прописати якщо ви хочете виводити кількість публікацій у перехресному посиланні. Наприклад актриса «Alina Ferdis» у вас прописана у 120-ти публікаціях, якщо увімкнути даний параметр, то на сторінці модулю, з права від «Alina Ferdis» у дужках буде зазначено «120».
Додатково дає можливість використовувати xf_sorting зі значенням count
Увага!!! Використання даного параметра, збільшить складність запитів до БД сайта, чим збільшить навантаження на сервер і час створення сторінки.
xf_alphabet=yes - Параметр який має лише одне значення yes, цей параметр треба прописати якщо ви хочете виводити абеткову пагінацію на сторінці модуля.
Увага!!! Використання даного параметра, збільшить складність запитів до БД сайта, чим збільшить навантаження на сервер і час створення сторінки.
xf_myalphabet=SSS - Стандартно абеткова пагінація на англійській мові. Якщо, вам потрібна абеткова навігація на іншій мові, даний параметр допоможе вам. Параметр має два значення заготовлених, а також дає можливість створити свої значення по шаблону. Замість SSS ви можете ввести:
"ua" – Виведе Українську абетку у пагінації
"ru" – Виведе російську абетку у пагінації
"X, X, X, X" – Можна створити свою власну абетку з різних літер, різних мов у будь якому порядку.
Приклад: "xf_myalphabet=W, J, R, Є, Ы, Н" на сайті буде пагінація: «W, J, R, Є, Ы, Н»
Увага!!! Літери повинні буди у великому регістрі, після літери йде кома и пробіл. Кома і пробіл, це для розділення літер і після останньої літери ставити їх не треба.
Працює лише разом з увімкненою абетковою пагінацією (параметром "xf_alphabet=yes")
xf_titleErrors=ERR - Параметр дає змогу прописати свій текст, для заголовка сторінки з помилкою (якщо у якоїсь літери у абетковій навігації немає жодної публікації – моделі у якої ім’я починається на вибрану літеру). Просто замініть ERR на свій текст.
Стандартний текст для параметра: «Attention, an error has been detected!»
Працює лише разом з увімкненою абетковою пагінацією (параметром "xf_alphabet=yes")
xf_textErrors=ERT - Параметр дає змогу прописати свій текст поилки, для сторінки з помилкою (якщо у якоїсь літери у абетковій навігації немає жодної публікації – моделі у якої ім’я починається на вибрану літеру). Просто замініть ERT на свій текст.
Стандартний текст для параметра: «Unfortunately, no model was found for the letter "Тут літера яка видала помилку" Try choosing another letter.»
Працює лише разом з увімкненою абетковою пагінацією (параметром "xf_alphabet=yes")
xf_domain=https://AAA - В даному параметрі можна вказати альтернативний домен, де будуть знаходитися постери для перехресних полів.
Це корисно якщо у вас багато сайтів (бажано) на одному сервері, і ви не маєте бажання для кожного сайта завантажувати постери окремо (багато місця займають). Треба прописувати домен так: https://lexss.org