|
2 | 2 | keyword: IntroductionPage
|
3 | 3 | ---
|
4 | 4 |
|
5 |
| -This library provides a quick and easy wrapper for [CookieConsent V3](https://cookieconsent.orestbida.com). |
| 5 | +`ngx-cookies` is an Angular based package providing GDPR compliant cookie handling solutions. |
6 | 6 |
|
7 |
| -The `ngx-cookies` package was made as an extension on top of the vanilla CookieConsent in order to provide several Angular based functionalities such as a setup through a server, Observables for the provided events and a directive to handle cookie based content. |
| 7 | +## For organisations |
8 | 8 |
|
9 | 9 | The package refrains from adding too much custom logic and is entirely based on the existing CookieConsent API. We refer to the documentation of said package for more information regarding the setup of the cookie handler.
|
| 10 | +In today's digital landscape, proper cookie management isn't just about functionality - it's about legal compliance and user trust. Our cookies package ensures your application handles user consent and cookie management in a GDPR compliant way. |
| 11 | + |
| 12 | +By implementing standardized cookie consent flows and management tools, we help organizations meet their legal obligations while maintaining a positive user experience. Our solution provides clear cookie categorization, user-friendly consent management, and proper documentation of user choices. |
| 13 | + |
| 14 | +We also ensure that cookies are only set after explicit user consent, with proper mechanisms for users to change their preferences at any time. This proactive approach to privacy helps build trust with your users while protecting your organization from potential compliance issues. |
| 15 | + |
| 16 | +Our package helps organisations by providing: |
| 17 | + |
| 18 | +- **GDPR Compliance**: Built-in support for cookie consent and management |
| 19 | +- **Risk Mitigation**: Proper handling of user consent reduces legal risks |
| 20 | +- **User Trust**: Transparent cookie management builds user confidence |
| 21 | +- **Easy Implementation**: Ready-to-use solutions for cookie compliance |
| 22 | +- **Flexible Control**: Granular cookie categories and consent management |
| 23 | +- **Audit Ready**: Proper documentation of user consent choices |
| 24 | + |
| 25 | +Looking for more information on how this package can help you out in your application? Mail us at [[email protected]](mailto:[email protected]) |
| 26 | + |
| 27 | +## For developers |
| 28 | + |
| 29 | +The `ngx-cookies` package provides a comprehensive solution for implementing cookie management in your Angular applications. It handles everything from consent management to cookie operations while ensuring GDPR compliance. |
| 30 | + |
| 31 | +Here's what you can do with our cookie management system: |
| 32 | + |
| 33 | +### Cookie Management |
| 34 | + |
| 35 | +```typescript |
| 36 | +// Set cookies with consent checking |
| 37 | +constructor(private cookieService: NgxCookieService) { |
| 38 | + // Only sets cookie if user has given consent for this category |
| 39 | + this.cookieService.set('preference', value, { |
| 40 | + category: CookieCategory.PREFERENCES |
| 41 | + }); |
| 42 | +} |
| 43 | + |
| 44 | +// Check consent before operations |
| 45 | +if (this.cookieService.hasConsent(CookieCategory.ANALYTICS)) { |
| 46 | + // Perform analytics operations |
| 47 | +} |
| 48 | +``` |
| 49 | + |
| 50 | +### Consent Management |
| 51 | + |
| 52 | +```typescript |
| 53 | +// Handle cookie consent |
| 54 | +export class CookieConsentComponent { |
| 55 | + constructor(private consentService: NgxCookieConsentService) { |
| 56 | + // Get current consent status |
| 57 | + this.consentService.getConsent().subscribe(consent => { |
| 58 | + this.currentConsent = consent; |
| 59 | + }); |
| 60 | + } |
| 61 | + |
| 62 | + updateConsent(categories: CookieCategory[]) { |
| 63 | + this.consentService.updateConsent(categories); |
| 64 | + } |
| 65 | +} |
| 66 | +``` |
| 67 | + |
| 68 | +### Cookie Banner Integration |
| 69 | + |
| 70 | +```typescript |
| 71 | +// Automatic banner handling |
| 72 | +@Component({ |
| 73 | + template: ` |
| 74 | + <ngx-cookie-banner |
| 75 | + [showBanner]="showBanner$ | async" |
| 76 | + (acceptAll)="handleAcceptAll()" |
| 77 | + (customize)="handleCustomize()"> |
| 78 | + </ngx-cookie-banner> |
| 79 | + ` |
| 80 | +}) |
| 81 | +export class AppComponent { |
| 82 | + showBanner$ = this.consentService.shouldShowBanner(); |
| 83 | +} |
| 84 | +``` |
| 85 | + |
| 86 | +New features and improvements are regularly added to ensure continued compliance with evolving privacy regulations and best practices. |
0 commit comments