Download the PHP package eveltic/cookie-bundle without Composer
On this page you can find all versions of the php package eveltic/cookie-bundle. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
FAQ
Example:
In general, it is recommended to use always a project to download your libraries. In an application normally there is more than one library needed.
- Some hosting areas are not accessible by a terminal or SSH. Then it is not possible to use Composer.
- To use Composer is sometimes complicated. Especially for beginners.
- Composer needs much resources. Sometimes they are not available on a simple webspace.
- If you are using private repositories you don't need to share your credentials. You can set up everything on our site and then you provide a simple download link to your team member.
- Simplify your Composer build process. Use our own command line tool to download the vendor folder as binary. This makes your build process faster and you don't need to expose your credentials for private repositories.
Informations about the package cookie-bundle
Eveltic Cookie Bundle
The Eveltic Cookie Consent Bundle is a Symfony package to implement and manage user cookie consents on websites, thus complying fully with the newest 2024 AEPD regulations. It provides an easy-to-use interface to configure, collect, and store the preferences of user consent.
Different types of cookie settings can be configured for technical, analytical, preference, and advertisement cookies. It features easy-to-use templates, multilingual support, and is easy to implement in Symfony applications to ensure that your website is within the bounds of the law.
All operations are managed through ajax requests without the need of any refresh.
Images
Banner
Configure cookies
Retract from consent
Floating button
Retract button and consent details
Features
- Manage cookie consent categories: technical, preferences, analytics, and ads (you can configure all categories adding or removing according to your needs).
- Configure expiration period for cookies.
- Support for light, dark, and auto theme modes.
- Command line tools for archiving cookie consent data.
- Integration with Doctrine ORM.
- Fully featured twig display.
- Twig and backend functions to check if consent is accepted.
- Cookie versioning to force the user to reconsent.
Installation
-
Require the Bundle via Composer: This command will download and install this bundle inside your composer folder.
-
Run install command This command will create the necesary files in order to be able to adequate to your configuration needs.
- Update the database If you force update the database:
or if you are using migrations:
- Add the functions to your template (View Usage section)
`
Uninstall
Since there is no flex recipe, when uninstalling this bundle you need to manually remove the config files that were installed with the installation command. If you uninstall the bundle and doesn't remove those files the app will throw and exception telling you about this problem.
Configuration
If you ran the installation command all configuration files were in their corresponding folder. If you dont ran the command and you want to configure these are the files you need:
config/packages/eveltic_cookie.yaml
Available Configuration Options
categories: Define the categories of cookies and whether they are required.domain: Set the domain for the cookies.expiration: Set the cookie expiration period.version: Specify the version of your cookie consent policy.theme_mode: Choose the theme mode for the consent dialog ('light', 'dark', 'auto').
config/routes/eveltic_cookie.yaml
Usage
Functions
Twig Functions
{{ ev_cookie_render() }}
Renders the cookie consent banner. This function generates the HTML content for displaying the cookie consent dialog based on the user's current preferences. This function should be included in a layout or template where you want the cookie consent banner to appear.
{{ ev_cookie_is_category_accepted('analytics') }}
{{ ev_cookie_is_category_accepted(['technical', 'analytics'])) }}
Checks if a specific cookie category (e.g., "technical", "analytics") is accepted by the user. This function is useful for conditionally loading scripts or other assets based on the user's consent for specific categories. This function support both string and array inputs. If you provide an array input both conditions must be true to return true.
{{ ev_cookie_show_cookie_banner() }}
Determines if the cookie consent banner should be shown to the user. This typically checks if the user has already provided consent. This function allows you to control whether the consent banner should be displayed, avoiding unnecessary re-rendering.
{{ ev_cookie_include_js() }}
Includes the JavaScript necessary for handling cookie consent interactions on the frontend. Place this in your template to ensure the necessary JavaScript is included for managing cookie consent.
{{ ev_cookie_include_css() }}
Includes the CSS styles for the cookie consent banner. This function is used to add the styling needed for the cookie consent banner.
{{ ev_cookie_include_assets() }}
Includes both the JavaScript and CSS assets required for the cookie consent banner in one go. This function is a convenience method to include both the JavaScript and CSS with a single function call, making it easier to integrate into your templates.
Usage Example
Backend Functions Provided by CookieConsentService
$cookieConsentService->getConsent()
Retrieves the current cookie consent data from the user's session or cookies.
$cookieConsentService->hasConsented()
Checks whether the user has already provided consent for cookies. This function can be used to determine whether to display the cookie consent banner.
$cookieConsentService->isCategoryAccepted(string $category)
Determines if a specific cookie category has been accepted by the user.
- Parameters:
- $category: The name of the cookie category you want to check (e.g., "analytics", "preferences").
Commands
Installs the necessary assets and settings for the cookie consent management.
Archives old cookie consent data to keep your database clean.
Parameters
--date: (optional) Allows you to specify a date in the Y-m-d format (e.g., 2023-01-01). This parameter indicates that all records before this date will be archived.--output-format: (optional) Specifies the output format for the archived records. Available options are:log: Saves the archived records in a LOG file.csv: Saves the archived records in a CSV file.html: Saves the archived records in an HTML file.
--dry-run: (optional) Performs a simulation of the archiving process without actually modifying any data in the database. This is useful for previewing which records would be archived without making permanent changes.
Translations
This bundle supports multiple languages for the consent banner. Available translations include:
- German (de)
- Spanish (es)
- French (fr)
- Italian (it)
- Dutch (nl)
- Polish (pl)
- Portuguese (pt)
- Russian (ru)
- Catalan (ca)
Contributing
Contributions are welcome! Please fork the repository and submit a pull request for any features, bug fixes, or improvements.
License
This bundle is released under the MIT License. See the LICENSE file for more details. Feel free to use in any condition and modify all as you want.
All versions of cookie-bundle with dependencies
symfony/framework-bundle Version ^6.0 | ^7.0
symfony/orm-pack Version ^2.3
twig/twig Version ^3.0
symfony/yaml Version ^6.0 | ^7.0
symfony/asset Version ^6.0 | ^7.0
symfony/console Version ^6.0 | ^7.0
symfony/http-foundation Version ^6.0 | ^7.0
symfony/http-kernel Version ^6.0 | ^7.0
symfony/dependency-injection Version ^6.0 | ^7.0