Getting Started

Minimal Setup

Install the Bundle
```
composer require alteis/hagreed-bundle
```

Configure .env Add your Hagreed token:

HAGREED_TOKEN="your-token-from-hagreed.com"

Register the Bundle Add to config/bundles.php:

Alteis\HagreedBundle\AlteisHagreedBundle::class => ['all' => true],

Add to Twig Include in your base template:

<head>
    {{ header_hagreed() }}
</head>
<body>
    {{ body_end_hagreed() }}
</body>

First Use Case: Basic Consent Banner

Trigger the banner via JavaScript:

<a href="javascript:window.hagreedBundle.displayBanner()">Manage Cookies</a>

Verify functionality by testing cookie consent storage in browser dev tools.

Implementation Patterns

Core Workflow: Consent Management

Initialization

Configure alteis_hagreed.yaml with:

alteis_hagreed:
    token: '%env(HAGREED_TOKEN)%'
    timeout: 5000  # Auto-show delay (ms)
    turbo: true     # If using Hotwire Turbo

Customize Consents Define cookie categories and purposes in YAML:

cookies:
    - id: analytics
      name: "Analytics"
      category: STATISTICS
      link: "https://example.com/privacy"

Form Integration Map forms to consent purposes:

consents_form_list:
    - id: contact_form
      title: "Data Processing"
      purposes:
          - slug: "marketing"
            name: "Receive newsletters"
            mandatory: false

Export Consents Fetch user consents via:

$consents = $this->apiHagreed->exportConsents($userEmail);

Integration Tips

Turbo Compatibility: Set turbo: true to avoid banner reloading on SPA transitions.
Language Handling: Force language via force_lang: true or auto-detect with lang: fr|en.
Dynamic Templates: Override default templates by extending the bundle’s Twig paths.

Gotchas and Tips

Pitfalls

Turbo Conflicts
- Issue: Banner reappears on Turbo-driven navigation.
- Fix: Set turbo: true in config and ensure importmap.php includes:
```
'@tizy/hagreed/hagreed.js' => ['version' => '1.2.7'],
```
Token Validation
- Issue: Silent failures if HAGREED_TOKEN is invalid.
- Debug: Check Symfony logs for API errors or use:
```
php bin/console debug:config alteis_hagreed
```
Cookie Storage
- Issue: Consents not persisting across subdomains.
- Fix: Configure SameSite and Domain attributes in Hagreed’s dashboard.

Debugging

API Calls: Use ApiHagreedInterface to test endpoints:

$this->apiHagreed->exportConsents('test@example.com');

Twig Errors: Clear cache after template changes:
```
php bin/console cache:clear
```

Extension Points

Custom Templates Override templates/alteis_hagreed/ in your bundle to modify banner UI.
Event Listeners Extend consent logic via Symfony events (e.g., hagreed.consent.saved).
Advanced Config Use environment variables for dynamic settings:
```
timeout: '%env(int:HAGREED_TIMEOUT)%'
```

Hagreed Bundle Laravel Package