Допомога
Модуль Joomla відображає випадкову цитату з колекції спільноти користувачів www.zitat-service.de/uk/. Вибір цитат може бути обмежений однією з п'яти мов, одним з понад 500 авторів, однією з понад 500 категорій або цитатами, встановленими самими користувачами. Ми працюємо в Інтернеті з 2007 року, безкоштовно і без реклами.
Note
Для модуля існує демонстраційний сайт на Joomla 5: joomla.zitat-service.de/uk/
Модуль Joomla zitat-service.de підтримує Joomla версій 3, 4 та 5. Модуль можна встановити в бекенд Joomla від імені адміністратора через Встановлення розширень:
- з каталогу розширень Joomla! Extensions Directory™ (JED) за допомогою
Встановити з JEDі пошуку Zitat (рекомендується) - або безпосередньо за допомогою
Встановити з теки: https://github.com/muhme/quote_joomla/releases/download/2.0.3/mod_zitat_service_de_2.0.3.zip
Як і у випадку з будь-яким новим модулем Joomla, для того, щоб зробити модуль видимим, необхідно виконати початкове налаштування. Як адміністратор Joomla, перейдіть до Система | Модулі сайту | zitat-service.de:
- Позиція: наприклад,
Sidebar-right. - Статус:
<Опубліковано - Призначення меню: (типово)
На всіх сторінках.
Tip
Короткі підказки до полів введення відображаються за допомогою Показати допомогу.
За допомогою базових параметрів модуля можна обмежити відображення цитат:
- певним
Автором(наприклад, Тарас Григорович Шевченко), -
Категорією(наприклад, Футбол), або - "Користувачем".
Тут користувачі - це імена користувачів, які створили цитати. Це дозволяє вам, наприклад, вибрати цитати, які ви створили самі.
Вибір * представляє всіх авторів, всі категорії і всіх користувачів.
Існує три основні варіанти вибору мови цитати:
-
uk- Українська, як приклад конкретної мови. -
frontend- для цитат мовою, що використовується Joomla. Якщо мова не підтримується, використовується англійська. -
all- для відображення лапок всіма мовами.
Вкладка Розгорнутий надає додаткові можливості налаштування.
Цитати пов'язуються між собою, і, якщо це можливо, автор і джерело також пов'язуються між собою. Ці посилання відкриваються в тому ж вікні/вкладці браузера. Щоб посилання відкривалися в іншому вікні/вкладці браузера, у полі Ціль для HTML-посилань слід ввести ім'я, наприклад, quote_links.
Поле Метод запиту визначає спосіб отримання котирувань. Рекомендований метод запиту - Асинхронно з JavaScript у веб-браузері. Цей метод отримує котирування паралельно із завантаженням сторінки, таким чином прискорюючи процес завантаження сторінки. І навпаки, при методі запиту З Joomla котирування завантажуються разом із завантаженням сторінки. Перевага цього методу полягає в тому, що він дозволяє вбудовувати модуль кілька разів на сторінку.
Оскільки асинхронний метод запиту отримує ціну після того, як сторінка вже завантажена, наступні модулі можуть перестрибнути. Тому модуль повинен бути останнім у серії (щоб залишити місце під ним) або залишати зарезервоване місце по горизонталі. Мінімальну висоту модуля можна вказати за допомогою параметра Висота (CSS). Мінімальна висота може бути встановлена, наприклад, на 20ex або 200px. Категорія WebDesignTest з вибором мови all добре підходить для тестування висоти, оскільки містить найкоротші і найдовші лапки.
Tip
Або модуль розміщується внизу сторінки.
Відображену цитату можна стилізувати за допомогою Cascading Style Sheets (CSS). DIV-елемент класу quote охоплює всю цитату, де, наприклад, можна встановити рамку. Він містить два DIV-елементи класів quotation для цитати і source для автора і джерела. У наступному прикладі видаляється стандартне оформлення посилання (підкреслення), встановлюється чорний шрифт і більший за звичайний розмір цитати. Джерело (як з посиланням, так і без нього) відображається сірим кольором:
Для цього створіть Новий файл в директорії CSS використовуваного шаблону:
div.quote * a {
text-decoration: none;
color: black;
font-size: larger;
}
div.quote div.source, div.quote div.source a {
color: gray;
}- стилізовані під тематику сайту digitalflem.com:
Станом на 16 грудня 2023 року
404 No quote found for given parameters
Якщо параметри комбінуються несприятливо, для вибору не залишиться жодної цитати. У наступному прикладі налаштовано мову іспанська та автора Дуглас Адамс. Однак, іспанською мовою не буде збережено жодної цитати Дугласа Адамса:
404 No quote found for given parameters: language=es (Spanish), authorId=345 (Douglas Adams). "https://api.zitat-service.de/v1/quote_html?contentOnly=true&V_2.0.1_5.0.0_S&language=es&authorId=345"
👉 Виберіть параметри так, щоб цитати було знайдено.
Error: Failed to fetch (refused to connect)
Якщо CSP (Content Security Policy) увімкнено і виникає повідомлення про помилку, наприклад
Error: Failed to fetch "https://api.zitat-service.de/v1/quote_html?contentOnly=true&language=uk"
Будь ласка, перевірте помилку в консолі JavaScript браузера. Якщо ви знайдете там наступне:
zitatservice.js:32 Refused to connect to 'https://api.zitat-service.de/v1/quote_html?contentOnly=true&language=uk' because it violates the document's Content Security Policy.
👉 Тоді конфігурацію CSP (Content Security Policy) на сайті потрібно доповнити connect-src для API, щоб мати можливість отримувати цитати звідти. Наприклад, у конфігурації Apache:
# CSP
Set Content-Security-Policy "connect-src 'self' api.zitat-service.de;"
👉 Альтернативно, Метод запиту для модуля можна змінити на З Joomla.
RuntimeException Connection timed out
Для отримання котирування дозволяється максимум три секунди. Якщо час перевищено, буде виведено повідомлення про помилку, наприклад
RuntimeException Connection timed out after 3000 milliseconds "https://api.zitat-service.de/v1/quote_html?contentOnly=true"
👉 Це може статися за дуже поганого з'єднання з мережею. Якщо сервіс дійсно недоступний, будь ласка, створіть тікет.
Error: Invalid data "Goethe" for parameter "authorId"
У попередніх версіях плагіна (до 2.0.0) для параметрів, що налаштовуються, використовувалися імена, але після оновлення плагіна вони більше не працюють. У наведеному нижче прикладі в якості автора було збережено Goethe:
Error: Invalid data "Goethe" for parameter "authorId". "https://api.zitat-service.de/v1/quote_html?contentOnly=true&authorId=Goethe"
👉 Після оновлення плагіна до версії 2.0.0, збережені параметри, такі як автор, категорія та користувач, мають бути вибрані повторно, щоб перейти на унікальні ідентифікатори.
Виникла помилка або потрібне покращення? Будь ласка, створіть Питання на GitHub 👍