Skip to content

Commit 5fd4397

Browse files
committed
docs(cookies): add organisations section to introduction page -- closes #304
1 parent 17e3b97 commit 5fd4397

File tree

1 file changed

+79
-2
lines changed
  • apps/docs/src/app/pages/docs/angular/cookies/introduction

1 file changed

+79
-2
lines changed

apps/docs/src/app/pages/docs/angular/cookies/introduction/index.md

Lines changed: 79 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -2,8 +2,85 @@
22
keyword: IntroductionPage
33
---
44

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.
66

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
88

99
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

Comments
 (0)