Despite its name and the fact that it is documented as a part of feincms3, feincms3-cookiecontrol can also be used standalone.
Cookie control
Some jurisidictions require the the users’ consent before adding analytics scripts and tracking cookies. While it may be best to not use any analytics and tracking at all this may not be possible or even desirable in all circumstances.
Many solutions exist for adding a consent banner to the website. Some of those banners require loading JavaScript and other assets from external servers. This raises some questions because loading those scripts may also be seen as tracking already. It is certainly safer to implement a cookie control panel locally. It would be boring to start from scratch on each site.
This guide explains how to use feincms3-cookiecontrol.
Installation
Install the package:
pip install feincms3-cookiecontrolAdd feincms3_cookiecontrol to INSTALLED_APPS:
INSTALLED_APPS = [
# ...
"feincms3_cookiecontrol",
]Apply the initial migration:
python manage.py migrateAdd the panel to the template, e.g. in base.html at the end of the <body> element:
<!doctype html>
<html>
...
<body>
...
{% load feincms3_cookiecontrol %}{% feincms3_cookiecontrol %}
</body>
</html>You’ll have to add all tracking scripts yourself now.
The presentation of the panel is a fixed banner at the bottom of the viewport. Once any cookies have been accepted (essential cookies have to be accepted, e.g. the CSRF cookie) the banner is replaced by a single button which allows showing the control panel again.
Customize the appearance
The default colors of the control panel may not fit into your site. The best way to customize the appearance is to set a few CSS variables, e.g.:
.f3cc {
--f3cc-background: #e9e9e9;
--f3cc-foreground: #000000;
--f3cc-button-background: #cbcbcb;
--f3cc-accept-background: #90f690;
--f3cc-button-foreground: #cbcbcb;
--f3cc-accept-foreground: #cbcbcb;
}It’s recommended to set all variables if you set a single one; the exception is --f3cc-button-foreground which defaults to the value of --f3cc-foreground and --f3cc-accept-foreground which defaults to the value of --f3cc-button-foreground.
Using the panel from a different site
The panel can be integrated into another site by following these steps.
Set the domain for the cookie so that the cookie is available on subdomains (be sure to check the relevant guides to understand what the problems may be when doing this and what restrictions you have to honor):
COOKIECONTROL = {"domain": "example.com"}Add the view and optionally provide the privacy policy URL:
from feincms3.root.passthru import reverse_passthru_lazy
from feincms3_cookiecontrol.views import inject
urlpatterns = [
# Base case
path("f3cc-inject.js", inject),
# Using reverse_passthru_lazy.
# NOTE! The inject view uses `request.build_absolute_uri` to
# complete the URL, you do not have to add the domain and
# protocol yourself here.
path(
"f3cc-inject.js",
inject,
{"privacy_policy_url": reverse_passthru_lazy("privacy-policy", fallback="/")},
),
]Embed the script:
<script async src="https://example.com/f3cc-inject.js"></script>Selectively embed iframes or other third party scripts
If users do not consent to your cookie policy, embedding third party scripts or iframes might violate data protection laws, since personal data is transfered to a third party without the users knowledge or consent. One way is to disable third party content alltogether or selectively asking users to consent to the data policies of specific providers. The letter is accomplished by the ‘conscious embed’ functionality.
You have to install the feincms3-cookiecontrol[embedding] extra for this to work.
Extend default providers in your settings.py:
EMBED_PROVIDERS = {
"some-provider": {
"title": "Mailchimp",
"privacy_policy_url": "https://mailchimp.com/legal/privacy/",
},
}Surround the embedded code with the template block embed:
...
{% load feincms3_cookiecontrol %}
...
<div class="container">
{% wrap "mailchimp" %}
<script src="https://some-provider.com/example.js"></script>
{% endwrap %}
</div>
...Users that did not consent to your general cookie policy will now get asked to allow embedding content of specific providers.
You can also wrap your default renderer for embedded content plugins like feincms3.plugins.external or feincms3.embedding, but you have to explicitly specify the provider (as above with the {% wrap %} template tag).
If HTML is added dynamically to the site which contains such embedded fragments you have to call the f3ccRenderEmbeds() JavaScript function yourself to embed the third party content which has already been accepted by the user.
Automatically embedding content using an URL only
The feincms3_cookiecontrol.embedding module also offers an embed function where you can only pass an URL and either you get back the wrapped embed code or nothing at all. You may also specify your own embed providers; in this case you should also add a handler key to the EMBED_PROVIDERS setting; the function only receives the URL and returns either the embedding HTML or None if the URL isn’t using the provider at all. At the time of writing the module supports embedding YouTube and Vimeo URLs.
You may use the embed shortcut as follows:
# ...
from feincms3_cookiecontrol.embedding import embed
# ...
class EmbeddedVideo(plugins.external.External, PagePlugin):
# ...
def embedded_html(self):
return embed(self.url)The same functionality is also available directly in templates:
...
{% load feincms3_cookiecontrol %}
{% embed plugin.url %}
...
Release files for feincms3-cookiecontrol 1.7.2
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| feincms3_cookiecontrol-1.7.2.tar.gz | 16.3 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| feincms3_cookiecontrol-1.7.2-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 48.0 kB
Release files / feincms3_cookiecontrol-1.7.2.tar.gz
| Download URL | feincms3_cookiecontrol-1.7.2.tar.gz |
|---|---|
| Size | 16.3 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
092c8590753ec79983b12e906cc001f2acc4256966f391fc0b20f4ae30529826
|
|
BLAKE2b-256 checksum How to use checksums |
b17058623b28e196bd88e2705836b6c47baabc6502e4c2b31fc07c6496ba1232
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Aug 26, 2026.
Transparency logRelease files / feincms3_cookiecontrol-1.7.2-py3-none-any.whl
| Download URL | feincms3_cookiecontrol-1.7.2-py3-none-any.whl |
|---|---|
| Size | 31.8 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
edd7e0666a39a306e6a7336c5237cde35b178e099b4f3d09f8795b1d9424122d
|
|
BLAKE2b-256 checksum How to use checksums |
da9850ccad221d3af9580d0492a4192f9a6e7b9ce02c9abcdafd36878109d5f4
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Aug 26, 2026.
Transparency log
