README.md

TYPO3 Extension content_defender

Define allowed or denied content element types in your backend layouts

Installation

Simply install the extension with Composer or the Extension Manager.

Usage

1. You only need to adjust the column configuration of your backend_layout

Restrict certain content element fields

• To allow a limited set of values for content element fields use allowed.field = [list of comma separated values]

Examples:

columns {
    1 {
        name = Column with header and textmedia elements
        colPos = 3
        colspan = 6
        allowed {
            CType = header, textmedia
        }
    }
}

columns {
    1 {
        name = Column with News plugin only
        colPos = 3
        colspan = 6
        allowed {
            CType = list
            list_type = news_pi1
        }
    }
}

Combine multiple content element fields

• The example allows multiple content element types (text and list) while restricting plugin types to news only.

Example:

columns {
    1 {
        name = A column with restricted list_type and "normal" CType
        colPos = 3
        colspan = 6
        allowed {
            CType = textmedia, list
            list_type = news_pi1
        }
    }
}

Deny certain content element types

• To remove a set of values from content element fields use disallowed.field = [list of comma separated values]

Examples:

columns {
    1 {
        name = Column without divider, plain html and table elements
        colPos = 3
        colspan = 6
        disallowed {
            CType = div, html, table
        }
    }
}

columns {
    1 {
        name = Column with header and list, without News plugin
        colPos = 3
        colspan = 6
        allowed {
            CType = header, list
        }
        disallowed {
            list_type = news_pi1
        }
    }
}

Limit the number of content elements

• To restrict the number of content elements use maxitems = [number of elements]

Example:

columns {
    1 {
        name = Column with one textmedia 
        colPos = 3
        colspan = 6
        allowed {
            CType = textmedia
        }
        maxitems = 1
    }
}

Enable maxitems count in page module (!experimental!)

• To show the count of remaiing content elements that can be created in a column, you can enable an integration of content_defender in the page module
• Please understand that this feature is very experimental and does not have high priority for bug fixing

TYPO3 10 and 11

• Add the provided TypoScript template

TYPO3 12 and above

• Add the provided Page TSconfig in your page.tsconfig_includes field

Community

• Thanks to b13 that sponsored the maintenance of this extension with a sponsorship
• Thanks to Wolfgang Wagner who sponsored the maintenance of this extension with a sponsorship
• Thanks to WACON Internet GmbH that sponsored the maintenance of this extension with a GitHub sponsorship
• Thanks to Daniel Goerz who wrote about content_defender in his blog useTYPO3
• Thanks to Marcus Schwemer who wrote about content_defender in his blog TYPO3worx