Skip to content

Commit 265dfa0

Browse files
committed
docs(cookies): add organisations section to introduction page -- closes #304
1 parent a64ddee commit 265dfa0

File tree

1 file changed

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

1 file changed

+79
-3
lines changed

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

Lines changed: 79 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -2,8 +2,84 @@
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

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.
9+
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.
10+
11+
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.
12+
13+
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.
14+
15+
Our package helps organisations by providing:
16+
17+
- **GDPR Compliance**: Built-in support for cookie consent and management
18+
- **Risk Mitigation**: Proper handling of user consent reduces legal risks
19+
- **User Trust**: Transparent cookie management builds user confidence
20+
- **Easy Implementation**: Ready-to-use solutions for cookie compliance
21+
- **Flexible Control**: Granular cookie categories and consent management
22+
- **Audit Ready**: Proper documentation of user consent choices
23+
24+
Looking for more information on how this package can help you out in your application? Mail us at [[email protected]](mailto:[email protected])
25+
26+
## For developers
27+
28+
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.
29+
30+
Here's what you can do with our cookie management system:
31+
32+
### Cookie Management
33+
34+
```typescript
35+
// Set cookies with consent checking
36+
constructor(private cookieService: NgxCookieService) {
37+
// Only sets cookie if user has given consent for this category
38+
this.cookieService.set('preference', value, {
39+
category: CookieCategory.PREFERENCES
40+
});
41+
}
42+
43+
// Check consent before operations
44+
if (this.cookieService.hasConsent(CookieCategory.ANALYTICS)) {
45+
// Perform analytics operations
46+
}
47+
```
48+
49+
### Consent Management
50+
51+
```typescript
52+
// Handle cookie consent
53+
export class CookieConsentComponent {
54+
constructor(private consentService: NgxCookieConsentService) {
55+
// Get current consent status
56+
this.consentService.getConsent().subscribe(consent => {
57+
this.currentConsent = consent;
58+
});
59+
}
60+
61+
updateConsent(categories: CookieCategory[]) {
62+
this.consentService.updateConsent(categories);
63+
}
64+
}
65+
```
66+
67+
### Cookie Banner Integration
68+
69+
```typescript
70+
// Automatic banner handling
71+
@Component({
72+
template: `
73+
<ngx-cookie-banner
74+
[showBanner]="showBanner$ | async"
75+
(acceptAll)="handleAcceptAll()"
76+
(customize)="handleCustomize()">
77+
</ngx-cookie-banner>
78+
`
79+
})
80+
export class AppComponent {
81+
showBanner$ = this.consentService.shouldShowBanner();
82+
}
83+
```
84+
85+
New features and improvements are regularly added to ensure continued compliance with evolving privacy regulations and best practices.

0 commit comments

Comments
 (0)