Opis
Istnieje wiele wtyczek WordPress, które robią wiele wymyślnych rzeczy ze zgodą na pliki ciasteczek. Nie znaleźliśmy takiej, która naprawdę by nam się podobała, która byłaby naprawdę lekka i przyjazna dla programistów, więc stworzyliśmy własną.
Nie jest przeznaczona dla mas, które chcą mnóstwa konfigurowalnych opcji w panelu administracyjnym (chociaż będzie działać i wyglądać dobrze od razu po wyjęciu z pudełka). Wiele osób używa tej wtyczki z domyślną stylizacją, ponieważ jest lekka i dobrze wygląda.
Dla deweloperów, którzy chcą funkcjonalności i możliwości wygodnego nadpisywania stylów w motywie – oto wtyczka dla ciebie. Masz do dyspozycji filtry i akcje na każdym etapie procesu.
Zobacz sekcję instalacji, aby uzyskać więcej informacji na temat instalacji. Sekcja FAQ zawiera ważne informacje na temat dostosowywania wtyczki.
Tłumaczenia
W skład pakietu wchodzą pełne tłumaczenia na następujące języki:
- Litewski (dzięki @batiufa)
- Szwedzki
- Oksytański (dzięki Mejans)
- Norweski
- Duński
- Węgierski
- Hiszpański
- Niemiecki
- Włoski
- Słoweński
Kompletny plik .pot jest dostępny w katalogu translations/. Jeśli korzystasz i przetłumaczysz tę małą wtyczkę, prosimy o przesłanie nam tłumaczenia, aby mogło zostać dołączone!
Jest jeszcze lepiej, jeśli używasz Translate.WordPress.org do tłumaczeń. W ten sposób będą one automatycznie dystrybuowane wraz z aktualizacją WordPress.
Jednakże, w niektórych ustawieniach regionalnych, praca z witryną Translate nie jest jeszcze na odpowiednim poziomie. Będziemy nadal wspierać dołączone tłumaczenia przez jakiś czas.
Zrzuty ekranu
Instalacja
Zalecamy skorzystanie z wbudowanego w WordPress instalatora wtyczek. Jeśli chcesz zainstalować wtyczkę ręcznie:
- Prześlij
ilmenite-cookie-consent
do katalogu/wp-content/plugins/
. - Włącz wtyczkę z menu „Wtyczki” w WordPressie.
- Wstaw odnośnik do polityki plików ciasteczek na stronie 'Ustawienia > Czytanie’.
Najczęściej zadawane pytania
-
Możesz ustawić adres URL do strony polityki plików ciasteczek w konfiguratorze w sekcji „Baner plików ciasteczek”, lub użyć filtra
ilcc_policy_url
, aby zwrócić własny odnośnik. -
Jak mogę dostosować styl lub całkowicie go wyłączyć?
-
Wtyczka zawiera lekki arkusz stylów z dwoma opcjami umieszczenia (u góry oraz jako nakładka). Jeśli nie chcesz używać naszej domyślnej kolorystyki, łatwo możesz zapobiec dołączeniu stylów.
Po prostu zdefiniuj następujący filtr gdzieś w swoim kodzie, na przykład w pliku functions.php motywu:
add_filter( 'ilcc_load_stylesheet', '__return_false' );
Dodatkowo, w celu szybkiego dostosowania do własnych kolorów motywu, wspieramy serię zmiennych CSS ustawionych w
body.has-ilcc-banner
w następujący sposób:body.has-ilcc-banner { --ilcc-background-color: #282b2d; --ilcc-text-color: #ccc; --ilcc-link-color: #ccc; --ilcc-link-color-hover: #fff; --ilcc-banner-spacing: 1.4rem 0; --ilcc-close-button: #474d50; --ilcc-close-button-hover: #666; --ilcc-close-button-text: white; --ilcc-close-button-hover-text: white; --ilcc-button-radius: 4px; }
Jeśli chcesz dodać własny styl oprócz dwóch oferowanych, możesz zastąpić ustawienia stylu filtrem
ilcc_style
. Pozwoli ci to stylizować poza dwiema podstawowymi pozycjami. -
Możesz zmienić dwa wiersze tekstu i etykietę przycisku w konfiguratorze w sekcji „Baner plików ciasteczek”. Alternatywnie możesz użyć zestawu filtrów, aby zwrócić wartości przed renderowaniem.
Modyfikowanie tytułu:
ilcc_consent_title
Modyfikowanie tekstu informacyjnego:ilcc_consent_text
Modyfikowanie etykiety przycisku akceptacji:ilcc_accept_text
Wystarczy ustawić ich wartość gdzieś w kodzie, na przykład w pliku functions.php motywu:
function ilcc_modify_consent_text( $text ) { $text = __( 'This is my custom text about how we use cookies.', 'YOURTEXTDOMAIN' ); return $text; } add_filter( 'ilcc_consent_text', 'ilcc_modify_consent_text' ); function ilcc_modify_accept_text( $text ) { $text = __( 'I Accept', 'YOURTEXTDOMAIN' ); return $text; } add_filter( 'ilcc_accept_text', 'ilcc_modify_accept_text' );
-
Jakie działania są dostępne?
-
ilcc_loaded – Uruchamia się podczas konstruktora.
before_ilcc_init - Runs before we have run any init actions. ilcc_init - Runs when all init hooks have run.
-
Jakie filtry są dostępne?
-
ilcc_has_user_consented – Określa, czy użytkownik wyraził zgodę, czy nie. Wartość true lub false. Posiada argumenty $cookie_name i $cookie_value.
ilcc_cookie_active_value - Set which value is "active" for the cookie, ie. consented. Defaults to 1. ilcc_cookie_name - Set the name of the cookie. Defaults to 'EUConsentCookie'. ilcc_accept_text - Set the accept button text. ilcc_consent_text - Set the consent text. Has $policy_url as argument. ilcc_policy_url - Allows you to modify the Policy URL. Has the url from the options as argument. ilcc_style - Allows you to set your own style name. ilcc_edit_text_capability - Allows you to modify which capability is required for editing the cookie banner text (below the title) in the customizer. Defaults to `edit_theme_options`. ilcc_edit_title_capability - Allows you to modify which capability is required for editing the cookie banner title in the customizer. Defaults to `edit_theme_options`. ilcc_edit_button_capability - Allows you to modify which capability is required for editing the cookie banner button label in the customizer. Defaults to `edit_theme_options`. ilcc_edit_policy_url_capability - Allows you to modify which capability is required for editing the policy URL in the customizer. Defaults to `edit_theme_options`. ilcc_edit_style_capability - Allows you to modify which capability is required for editing the cookie banner style in the customizer. Defaults to `edit_theme_options`. ilcc_load_stylesheets - (bool) Set if you want the stylesheets to be loaded or not. Defaults to true. ilcc_enable_customizer - Return false to disable all the customizer settings, if you'd like to prevent any user from changing any of the settings. ilcc_preferences_cookie_name - The name of the cookie that stores if a visitor has set their cookie preferences. ilcc_categories_cookie_name - The name of the cookie that stores the categories the visitor has opted in to. ilcc_tracker_settings_enabled - Return false to disable the tracker customization settings screen. ilcc_is_active_on_page - Return false to hide the banner from loading. Can be used to prevent the banner from loading on certain pages or templates.
Recenzje
Kontrybutorzy i deweloperzy
„Ilmenite Cookie Consent” jest oprogramowaniem open source. Poniższe osoby miały wkład w rozwój wtyczki.
ZaangażowaniWtyczka „Ilmenite Cookie Consent” została przetłumaczona na 3 języki. Podziękuj tłumaczom za ich wkład.
Przetłumacz wtyczkę “Ilmenite Cookie Consent” na swój język.
Interesuje cię rozwój wtyczki?
Przeglądaj kod, sprawdź repozytorium SVN lub czytaj dziennik rozwoju przez RSS.
Rejestr zmian
Version 3.2.0
- Dodano integrację z matomo
- Allow customizing consent sections
- Remove syncing debug mode with WP_DEBUG
- Usunięto zależności od jQuery
- Dodano język oksytański (dzięki Mejans)
Version 3.1.0
- Added a filter to prevent the banner from loading on specific pages or templates.
- Zadeklaruj wsparcie dla PHP 8 podczas wczytywania za pomocą composera.
Version 3.0.3
- Fixed a bug where domains were included in the disallow list even when they were supposed to be allowed. (#16)
Version 3.0.2
- Updated Lithuanian translation (thanks @batiufa)
- Fixed an array offset warning (#14)
Version 3.0.1
Fixed an issue where we passed script tags to an wp_add_inline_script function callback, causing a doing_it_wrong notice.
Version 3.0.0
Major update with potentially breaking changes.
We are now finally respecting not to set any tracking cookies unless the user has actually accepted all cookies. We keep a running list of trackers that we disable automatically. From analytics to marketing. You can modify the list of trackers via filters in the code or the settings screen.
As a developer, you can disable the settings screens via filters.
To support this, the plugin has been extended quite a bit. There are numerous new strings, filters and options.
We have also added a new style, „take over”, if you’d prefer to force the user to make a choice before allowing them into your website. The „overlay” style has now been made the default one for new installs.
- Added the
ilcc_preferences_cookie_name
filter to replace the now removedilcc_cookie_name
filter. - Added the
ilcc_categories_cookie_name
filter. - Added the
ilcc_remember_duration
filter. - Added the
ilcc_tracker_settings_enabled
filter. - Removed the
ilcc_has_user_consented
filter. - Removed the
ilcc_cookie_active_value
filter. - Replaced
ilcc_edit_text_capability
,ilcc_edit_title_capability
,ilcc_edit_button_capability
andilcc_edit_policy_url_capability
with a simplerilcc_edit_texts_capability
that takes the setting as an argument.
Version 2.0.5
When no policy URL is set in the customer, the default integrity policy URL from the WordPress settings will be loaded.
For those translating via WPML and Polylang, we have added a configuration file that makes the strings you add in the customizer translatable.
Version 2.0.4
Fixed a bug where the consent duration wasn’t set properly, resulting in us asking the user to consent way more often. The plugin will now (correctly) remember the consent for 30 days, unless the user clears their cookies.
Version 2.0.3
Fixed compatibility issues with jQuery 3. Thanks Viktor.
Version 2.0.2
Fixed a small issue where our build script wasn’t processing fallbacks for the new CSS variables correctly.
This could lead to the default style not loading properly in older browsers (such as IE 11). This update fixes
this behavior.
As a result, the variables are now defined on :root {}.
Version 2.0.1
Svn is svn. Contains nothing new apart from fixing the release archive.
If you managed to update to 2.0.0 in the few minute window before this was
addressed, 2.0.1 takes care of things for you. If not, enjoy the 2.0.0 update.
Version 2.0.0
In this major release we’ve made many code improvements as well as improvements to class names
and the JavaScript that powers most of the features. You will also have better and more
access to filters and actions for customization. Also, new customizer settings and a new core style
gives you quicker access to control the appearance of the banner.
- Improvement: Switched to setting the policy URL in the customizer instead of under Settings > Reading.
- Improvement: Added customizer settings for all texts as well.
- Improvement: Added a second core style „Overlay”, offering the option of showing the banner overlaid at the bottom instead of at the top.
- Improvement: Better class names for the consent box.
- Improvement: Re-structured the JavaScript code.
- Improvement: Ensure we get languages from all possible storage folders in WordPress.
- Improvement: Added filter to disable stylesheet loading.
- Improvement: Never process any of the the JS or CSS logic if the user has already consented.
- Improvement: Added filter when we check if user has consented.
- Improvement: Added filter for cookie name.
- Improvement: Added filter for cookie acceptance value.
- Improvement: Modified consent text filter to include the policy URL as a variable.
- Improvement: Added filter for when getting the policy URL.
- Improvement: Switched from an
<a>
tag for the acceptance button, to a more properbutton
. - Improvement: Added filters for controlling who may edit the settings in the customizer.
- Bug: Fixed a bug where the consent block could add to the DOM multiple times.
Version 1.1.4
Added Danish translation. (Thanks Magnus!)
Version 1.1.3
Added an Hungarian translation. (Thanks Miklos)
Version 1.1.2
Updated a string in the Spanish translation (thanks ibertrix)
Version 1.1.1
We managed to change a string we shouldn’t have changed in Version 1.1.0. Sorry about that!
Version 1.1.0
It’s time we switch this plugin over to above 1.0 releases.
– Changed the textdomain to conform with the plugin name = text domain. This means we will have full support for the WordPress.org Plugin translations.
– Added Italian translation (Thanks Matteo)
Version 0.2.9
- Ulepszone tłumaczenie na język niemiecki (dzięki Frank!)
- Dodano tłumaczenie na język litewski
- Minor Code Tweaks & Improvements (just behind the scenes—Thanks Johan)
Version 0.2.8
- Dodano tłumaczenie na język hiszpański (dzięki Vigdis!).
- Fixed a bug where the cookie banner height would be outputted in the JS console.
Version 0.2.7
- Dodano obsługę języka słowackiego (dzięki Peter!)
Version 0.2.6
- Dodano tłumaczenie na język norweski (Bokmål) (dzięki Kristofer!).
- Zaktualizowane tłumaczenie na język niemiecki o brakujące ciągi znaków
- Fixes dev mode constant
- Remove the GitHub Updater. Plugin will be added to the WordPress respository.
= Wersja 0.2.5**
– Zwiększenie wydajności: Nie wczytuj skryptów i styli, jeśli plik ciasteczka został już ustawiony.
Version 0.2.4
- Fixed a miss in the new CSS
Version 0.2.3
- Fixed a bug where the settings wouldn’t save due to an incorrectly specified settings area. (Thanks to jnylin https://github.com/jnylin)
- Dodano domyślne style przyjazne dla urządzeń mobilnych
Version 0.2.2
- Naprawiono błąd, w którym funkcja lokalizacji nie była wczytywana poprawnie.
- Naprawiono błąd, w którym niektóre domeny tekstowe nie były poprawnie określone.
Version 0.2.1
- Naprawiono błąd, w którym pliki językowe nie były wczytywane poprawnie.
Version 0.2.0
- Dodano aktualizator GitHub
- Dodano pole ustawień dla adresu URL polityki
- Zminimalizuj skrypty i style
- Dodano tłumaczenie na język niemiecki
Version 0.1.0
- Pierwsza wersja wtyczki.