b13 / cta
Adds a CTA Content-type to tt_content
Installs: 20 706
Dependents: 0
Suggesters: 0
Security: 0
Stars: 3
Watchers: 10
Forks: 1
Open Issues: 1
Type:typo3-cms-extension
Requires
- typo3/cms-backend: ^10.4 || ^11.0 || ^12.0
- typo3/cms-fluid-styled-content: ^10.4 || ^11.0 || ^12.0
This package is auto-updated.
Last update: 2024-11-08 15:02:02 UTC
README
About this extension
This extension adds dedicated fields for creating Call-to-action elements and optionally adds a new stand alone cta element to your TYPO3 project with a simple Fluid template for frontend rendering. It is intended as a basis to add link and cta functionality to your custom content elements like teasers, text elements.
Three fields are being added to table tt_content
: tx_cta_link
, tx_cta_linklabel
and tx_cta_linkconfig
; tx_cta_linkconfig
is rendered
as a dropdown by default.
To add CTA fields to other content elements you can make use of two different palettes:
linklabel
renders a link field and a corresponding link label field.linklabelconfig
adds a third field for additional configuration options per link.
Installing
Use composer to add this content element to your project
composer require b13/cta
and install the extension using the Extension Manager in your TYPO3 backend.
Update from Version < 2
We have changed the database fields
- link to tx_cta_link
- linklabel to tx_cta_linklabel
- linkconfig to tx_cta_linkconfig
Use the example cta element
If you want to make use of the basic cta element included as an example, add the TypoScript setup to your site-Extension setup:
@import 'EXT:cta/Configuration/TypoScript/setup.typoscript'
To add the element to the new content element wizard, also include the PageTSConfig in your templates:
@import 'EXT:cta/Configuration/PageTs/PageTs.tsconfig'
This will add the CTA element to the "common" tab (you can change this within your PageTSConfig of course).
Customizing
To make use of your own Fluid template add your template within your site-Extension using the template name "cta.html".
By default, the content element will show four fields:
- Layout
- Link
- Link label
- Link configuration
To remove fields you don't need, use PageTSConfig within your template configuration, like this:
TCEFORM.tt_content.layout.types.cta.disabled = 1
or better yet, use columnsOverride
configuration in your TCA.
To add options to the dropdown for either one of the dropdown fields, use PageTSConfig like this:
TCEFORM.tt_content.tx_cta_linkconfig.types.cta.addItems.inverted = Inverted Button
or, again, use columnsOverrides
in your TCA configuration.
License
As TYPO3 Core, cta is licensed under GPL2 or later. See the LICENSE file for more details.
Background, Authors & Further Maintenance
TYPO3 is highly configurable and it is easy to add custom content types or fields to the system using a few lines of TCA configuration, a simple PageTS configuration to add the type to the list of elements in the New Content Element Wizard, and a few lines of TypoScript and a Fluid Template. This extension adds a content type in the same way we create custom content types for our TYPO3 projects at b13.
EXT:cta
was initially created by David Steeb in 2017 for b13, Stuttgart. We use this as a basis to
add cta fields to tt_content
, render buttons and cta links, add cta elements to other content types (like adding a
call-to-action to a textmedia element) and as a general purpose "read more"-type of link field for teasers, sliders and
lots of different content types in general.
Find more TYPO3 extensions we have developed that help us deliver value in client projects. As part of the way we work, we focus on testing and best practices to ensure long-term performance, reliability, and results in all our code.