Skip to main content

This djangocms plugin allows you to create Call To Action (CTA) indicators, to display them as buttons in a Django CMS plugin, to track user click on these buttons on a GA conversion tunnel. Each CTA is linked with a fobi form which registers the user email in a given mailing list.

Project description

djangocms-call-to-action

A djangocms plugin that allows you to create Call To Action (CTA) indicators, to display them as buttons in a Django CMS plugin, to track user click on these buttons on a GA conversion tunnel. Each CTA is linked with a fobi form which registers the user email in a given mailing list.

This project is a WIP and might need some improvements.

Installation

This plugin requires Django-CMS, sendgrid, django-fobi.

  1. Install module using pipenv:
pipenv install djangocms-call-to-action
  • Or pip:
pip install djangocms-call-to-action
  1. Add it to your installed apps:
    "djangocms_call_to_action",
  1. Apply migrations
py manage.py migrate djangocms_call_to_action
  1. Include your sendgrid api key in your settings
DJANGOCMS_CTA_SENDGRID_API_KEY = "YOUR_API_KEY"
  • Or load it using an environment var:
import os
DJANGOCMS_CTA_SENDGRID_API_KEY = os.getenv("SENDGRID_API_KEY", None)
  1. Include your Google analytics GA code in your settings
DJANGOCMS_CTA_GA_UA = "UA-*******-*"
  • Or load it using an environment var:
import os
DJANGOCMS_CTA_GA_UA = os.getenv("GA_UA", None)
  1. Include the CTAFobiFormWidgetRedirectMiddleware before all other middlewares, and CTAPagePermissionMiddleware after django-cms CurrentPageMiddleware:
 MIDDLEWARE = (
   "djangocms_call_to_action.middleware.CTAFobiFormWidgetRedirectMiddleware",
   ...
   "cms.middleware.page.CurrentPageMiddleware",
   ...
   "djangocms_call_to_action.middleware.CTAPagePermissionMiddleware",
)
  1. Add djangocms_call_to_action.urls to your urls:
 urlpatterns = [
   ...
   path("cta/", include("djangocms_call_to_action.urls")),
   ...
   re_path("^", include("cms.urls")),
]

Optional settings

  1. Configure templates used to display the CMS plugin
from django.utils.translation import ugettext_lazy as _

DJANGOCMS_CTA_TEMPLATES = (("default.html", _("Link")), ("button_primary.html", _("Button primary")), ("button_secondary.html", _("Button secondary")),)
  1. Activate select2 for cms page selectors (requires django-select2)
DJANGOCMS_CTA_USE_SELECT2 = True
  1. Configure labels used for actions in GA
DJANGOCMS_CTA_DISPLAYED_USER_GA_LABEL = "Affiché"
DJANGOCMS_CTA_CLICKED_USER_GA_LABEL = "Cliqué"
DJANGOCMS_CTA_CONVERTED_USER_GA_LABEL = "Converti"
  1. Change cache duration for deny pages ids
DJANGOCMS_CTA_DENY_PAGES_IDS_CACHE_DURATION = 24 * 60 * 60 # Cache for 24h

How to use

  1. Create a fobi form using fobi interface.

In order to work properly with sendgrid registration, the form must contains the following fields: - First name - Last name - Email - An opt-in checkbox to consent the user email registration on sendgrid list

  1. Add the sendgrid handler to register the email address of the user into

  2. Create a CMS page to display the fobi form into

  3. Insert the fobi form into the new page, using the CMS plugin "Call to Action"

  4. On the django admin, create a Campaign linked with the CMS page created on step 4. Choose where the user will be redirected on form validation:

    • To an external link
    • To an internal link
    • To a file

You can choose to deny the access to the page if the form was not validated by the user.

  1. On your content, insert some CTA plugins to redirect to the form using the "Click To Action" cms plugin

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

djangocms-call-to-action-0.0.4.tar.gz (16.9 kB view details)

Uploaded Source

File details

Details for the file djangocms-call-to-action-0.0.4.tar.gz.

File metadata

  • Download URL: djangocms-call-to-action-0.0.4.tar.gz
  • Upload date:
  • Size: 16.9 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.1.1 pkginfo/1.5.0.1 requests/2.23.0 setuptools/45.1.0 requests-toolbelt/0.9.1 tqdm/4.46.1 CPython/3.7.3

File hashes

Hashes for djangocms-call-to-action-0.0.4.tar.gz
Algorithm Hash digest
SHA256 c8a0af858880b4e6ca92887f0f6489200f0dc00af1f8da12dd7f6b1136cec425
MD5 7bd94c941c7612cc64585f4d3ac271b0
BLAKE2b-256 00d590d6e60fcb9e0cfbd0ac33e37e6477b85cc30825ca1a0db4f86fae839e91

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page