Integrating SkillDisplay as content elements into TYPO3. https://www.skilldisplay.eu/
Go to file
2023-07-07 12:23:06 +02:00
.github/workflows [TASK] Remove dependency checker 2023-07-06 17:33:00 +02:00
Classes Merge pull request #15 from SkillDisplay/skill-grouping-vh 2023-07-07 12:23:06 +02:00
Configuration [FEATURE] Add optional caching for skill set data retrieval 2023-07-07 12:19:02 +02:00
Resources [TASK] added ViewHelper for grouping skills by their domainTag 2023-07-07 12:02:21 +02:00
Tests/Unit [BUGFIX] Fix broken TcaEnhancer unit tests 2021-02-02 11:22:59 +01:00
.gitignore [!!!][TASK] Update for TYPO3 11 & 12 2023-07-06 16:39:52 +02:00
composer.json [BUGFIX] Ignore missing API key exception 2023-07-06 18:34:18 +02:00
ext_emconf.php [!!!][TASK] Update for TYPO3 11 & 12 2023-07-06 16:39:52 +02:00
ext_localconf.php [FEATURE] Add optional caching for skill set data retrieval 2023-07-07 12:19:02 +02:00
ext_tables.sql [BUGFIX] Allow multi-value skillset selection 2023-07-07 09:04:40 +02:00
phpcs.xml.dist Ensure strict_types are defined 2021-01-23 15:52:16 +01:00
phpstan.neon Add unit tests 2020-09-24 08:39:53 +02:00
phpunit.xml.dist [TASK] Correct path to phpunit bootstrap 2023-07-06 17:55:05 +02:00
README.rst [FEATURE] Add optional caching for skill set data retrieval 2023-07-07 12:19:02 +02:00

TYPO3 Extension to integrate SkillDisplay

This TYPO3 extension integrates SkillDisplay into TYPO3 installations.

Right now it provides the following features:

  • Content element to render one or more skills.
  • Content element to render one skill set.
  • DataProcessor to fetch skills as entities via API.
  • DataProcessor to fetch skill sets as entities via API.
  • ViewHelper to generate verification button.
  • ViewHelper to generate verification URL.
  • ViewHelper to group skills by domain tag

Installation

Install the extension via Extension Manager or composer.

Add static TypoScript once installed and activated via Extension Manager. The TypoScript contains the rendering definition for provided content elements.

Next Step: Copy Templates or adjust template paths via TypoScript. In order to allow TYPO3 to find the Fluid templates for content elements, either add the path EXT:skilldisplay_content/Resources/Private/Templates/ContentElements/ in TypoScript, e.g.:

lib.contentElement {
    partialRootPaths {
        50 = EXT:skilldisplay_content/Resources/Private/Partials/ContentElements/
    }
    templateRootPaths {
        50 = EXT:skilldisplay_content/Resources/Private/Templates/ContentElements/
    }
}

Ensure the path has a lower number then your own paths and doesn't overwrite any existing number.

Or copy the files from /Resources/Private/Templates/ContentElements/ to your existing template folder.

Configuration

It is possible to cache the API results for Skill Sets with this TypoScript constant:

SkilldisplayContent.skillSet.cache = 1

You may include default CSS for the templates in your TypoScript:

page.includeCSS.skilldisplay = EXT:skilldisplay_content/Resources/Public/Css/Styles.css

Site configuration is extended, where options like API Key can be provided.

Also TypoScript and TSconfig is added to provide wizard entries for new content elements, as well as rendering. Both can be adjusted via custom TypoScript and TSconfig.

Usage

Add content elements to the pages and insert the ID of skills as comma separated list, or select one of the available skillsets. (The list includes all public SkillSets on the official SkillDisplay platform. Using custom SkillDisplay instances based on the Open Source extension is possible, check the skilldisplay/php-api package for more information)