Skip to content

Допомога

Jump to bottom
Heiko Lübbe edited this page May 11, 2024 · 17 revisions

Zitat-Service Плагін для WordPress Прапор України

Плагін для WordPress Випадкова цитата від Zitat-Service відображає випадкову цитату з колекції спільноти користувачів zitat-service.de. Вибір цитат може бути обмежений однією з п'яти мов, одним з понад 500 авторів, однією з понад 500 категорій або цитатами, встановленими самими користувачами. Ми працюємо в Інтернеті з 2007 року, безкоштовно і без реклами.

Note

Існує демонстраційний сайт WordPress, який використовує плагін: wp-demo.zitat-service.de

Встановлення

Ви можете встановити плагін Випадкова цитата від Zitat-Service безпосередньо з Каталогу плагінів WordPress або завантаживши zip-файл плагіна вручну. Спочатку натисніть Додати новий плагін у бекенді WordPress, а потім:

Після цього активуйте плагін:

plugin_uk

Note

Якщо для конфігурації під Microsoft Windows використовується браузер Firefox, у виборі мови також відображаються прапори країн у кодуванні UTF-8.

Використання

Ви можете вставити випадкову цитату у допис, сторінку або інші елементи вашого вебсайту, такі як футер, використовуючи блок Випадковий Цитат:

uk1

Ви можете налаштувати вибір цитат за мовою, категорією, автором цитати, а також за користувачем, який ввів цитату. Зірочка * представляє всі доступні опції. У виборі мови також можливий варіант Frontend, за яким використовується мовне налаштування користувача WordPress. Якщо мова користувача не підтримується, автоматично буде переключено на англійську мову. У наступному прикладі вибрані цитати українською мовою:

select_uk

Стилізація

Ви можете оформити цитату багатьма різними способами. По-перше, ви можете використовувати стандартні функції редактора блоків для стилю, такі як колір, типографіка та розміри. Наступний приклад використовує колір фону RGB AAFF0033 та внутрішній проміжок 1:

styling_1

По-друге, ви також можете використовувати форматування блоку Цитата в WordPress. Спочатку вставте блок Цитата, а потім вставте блок Випадковий Цитат всередину нього. З темою Twenty Twenty-Four, зовнішній блок Цитата використовує курсивний текст та закруглені кути. У наступному прикладі також встановлено колір фону RGB 00FFFF33 та Вирівнювання тексту по центру:

styling_2

По-третє, ви можете використовувати каскадні таблиці стилів (CSS). Елемент DIV класу quote охоплює всю цитату, наприклад, для встановлення відступу. Він містить елементи DIV quotation для самої цитати та source для автора та джерела. У наступному прикладі стандартна декорація посилання (синя та підкреслена) видаляється, і цитата відображається чорним кольором. Джерело (чи з посиланням, чи без нього) потім відображається сірим кольором. В цілому, у нас світло-сірий фон та 1 піксель широкий кордон з закругленими кутами:

styling_3

Для цього, у бекенді WordPress: Вигляд | Редактор | 🔍 | введіть CSS | та виберіть Додатковий код CSS

Додайте та збережіть наступні рядки:

div.quote {
  border: 1px solid black;
  border-radius: 1em;
  padding: 1em;
  background: #eee;
  text-align: justify;
}
div.quote * a {
  text-decoration: none;
  color: black;
}
div.quote div.source, div.quote div.source a {
  color: gray;
}

API zitat-service.de

Плагін WordPress отримує всі дані з api.zitat-service.de. Умови використання та заява про конфіденційність можна знайти в Імпресум.

Отримання цитат на веб-сайті WordPress виконується за допомогою коду PHP, який працює на сервері WordPress. Це означає, що процес отримання цитат не включає відстеження або запису специфічних для користувача даних на фронтенді. Натомість, він відбувається у середовищі сервера, що захищає конфіденційність користувача та забезпечує дотримання політик, які забороняють відстеження користувачів без їхньої згоди.

Показані цитати, разом з їхніми відповідними авторами та джерелами, посилаються на зовнішні веб-сайти, такі як zitat-service.de та Вікіпедія, щоб надати користувачам додатковий контекст та інформацію. Всі зовнішні посилання активуються тільки після ручного огляду адміністративною командою zitat-service.de, щоб уникнути зловживань з пов'язаним контентом.

Ситуації з Помилками

Error fetching quote

Якщо виникає проблема при отриманні цитати з api.zitat-service.de, відображається ця помилка. Наприклад, у середовищі playground.wordpress.net, де бекенд сервера PHP не підтримує мережеві з'єднання:

Error fetching quote

👉 Перевірте мережеве з'єднання на стороні сервера.

404 – No quote found for given parameters

Параметри комбінуються за допомогою AND. Якщо ваша комбінація не призводить до знаходження цитати, виникає помилка.

Параметри комбінуються таким чином, що повинні бути виконані всі умови. Якщо ваша комбінація параметрів не знаходить жодної цитати, показується ця помилка. Наприклад, немає цитат від Дугласа Адамса в категорії Сільське господарство:

Error: 404 – No quote found for given parameters: categoryId=151 (Agriculture), authorId=345 (Douglas Adams).

👉 Виберіть астериск * для Категорії, щоб показати цитати від Дугласа Адамса.

... (Цитата відсутня)

Є заповнювач ..., у разі проблем ці три крапки не замінюються випадковою цитатою:

...

👉 Перевірте консоль розробника браузера для мережевого запиту api.zitat-service.de та увімкніть налагодження JavaScript.

This block has encountered an error and cannot be previewed.

Якщо в редакторі блоків на бекенді виникають проблеми з блоком, блок випадкової цитати показує:

This block has encountered an error and cannot be previewed.

👉 Видаліть та створіть блок знову. Або перевірте вихідний код блоку в режимі Редактор коду замість стандартного режиму Візуальний редактор. Або увімкніть налагодження JavaScript.

Увімкніть налагодження JavaScript.

У консолі JavaScript браузера виконайте наступну команду:

> localStorage.setItem('debugMode', 'true');

👉 У консолі JavaScript ви тепер можете перевіряти повідомлення console.log та console.error від плагіна Випадкова цитата від Zitat-Service.

Ви можете знову деактивувати повідомлення консолі в консолі JavaScript за допомогою:

> localStorage.removeItem('debugMode');

Квитки

Чи є помилка чи потрібне вдосконалення? Будь ласка, створіть Issue на GitHub. 👍

Clone this wiki locally