README

[ ṯeufels ] Swiper NCE

Slider based on Swiper JS (https://swiperjs.com/) allows to use nested content elements in Slide

This version supports TYPO3

For TYPO3 v12 / v13 support use version 1.2.x

Composer support

composer req teufels/tt3-swiper-nce

Swiper.js Documents

• Getting Started Guide
• API
• Demos

Requirements

Swiper.js: >=6.8.4

How to use

• Install with composer
• Import Static Template (before sitepackage)
• make own Configurations
  • add Configurations to TsConfig/Page/TCEFORM.tsconfig in sitepackage
  • add own configuration js file to sitepackage & implement these in setup.typoscript of sitepackage

Update & Migration from hive_swiperjs_simple

Note: Migration from hive_swiperjs_simple is only supported up to version 1.2.x (TYPO3 v12/v13). Version 2.0.0+ requires TYPO3 v14 – at this point the migration must already have been completed.

For migration on TYPO3 v12/v13 use version 1.2.x:

1. in composer.json replace beewilly/hive_swiperjs_simple with "teufels/tt3-swiper-nce":"^1.0"
2. Composer update
3. Include TypoScript set [teufels] Swiper NCE
4. Analyze Database Structure -> Add tables & fields (do not remove old hive_swiperjs_simple yet)
5. Perform Upgrade Wizards [teufels] Swiper NCE
6. Analyze Database Structure -> Remove tables & unused fields (remove old hive_swiperjs_simple now)
7. class & id changed -> adjust styling in sitepackage (e.g. hive_swiperjs_simple => tx_tt3_swiper_nce)
8. check & adjust be user group access rights
9. migrate own configurations

Changelog

2.0.x

• 2.0.0 add support for TYPO3 v14 (breaking: requires TYPO3 v14, drops v12/v13 support)
  • remove Classes/Updates/ (UpgradeWizards for hive_swiperjs_simple migration) – no longer needed as hive_swiperjs_simple only ran on TYPO3 v12; migration must have been completed before upgrading to v14
  • migrate icon registration from ext_localconf.php to Configuration/Icons.php (required in TYPO3 v14 – instantiating IconRegistry in ext_localconf.php throws an exception)
  • remove deprecated $GLOBALS['BE_USER']->errorMsg in PreviewRenderer (deprecated since TYPO3 v14, use exception message directly)

    1.2.x

• 1.2.13 fix custom pagination for multiple slider on same page
• 1.2.12 TCA type=file: use common-image-types as allowed value for slide_bgimage instead of hardcoded file extensions
• 1.2.11 TCA migration for TYPO3 v13: type=language, type=datetime, type=number, type=file, remove cruser_id, associative items keys
• 1.2.10 add missing 'l10n_mode' => 'prefixLangTitle', field to TCA for Translation via deepltranslate_core
• 1.2.9 add headers to Plugin (TCA) and reorganize TCA
• 1.2.8 fix: replace private execute() calls with executeStatement() in DataUpdater for DBAL 3 compatibility
• 1.2.7 add support for Site Sets
• 1.2.6 replace missing doctrine/dbal 'getSchemaManager()'
• 1.2.5 remove alphanum_x from eval of slide_cssclass => no space possible with alphanum_x but needed to assign multiple classes
• 1.2.4 remove console.log initialization message
• 1.2 add support for TYPO3 v13
  • Fix: Adaptation to TYPO3 v13 - Use of TYPO3\CMS\Core\Database\Connection:PARAM_INT instead of \PDO::PARAM_INT
  • custom preview renderer only used for TYPO3 v12, TYPO3 v13 uses default renderer
  • add Previews for TYPO3 v13 and TYPO3 v12 support
  • remove usage of vhs:condition.string.contains (not TYPO3v13 ready yet -27.01.25-) using simple condition instead

    1.1.x

• 1.1.1 fix autoplay
• 1.1.0 New Features
  • add Autoplay Options disableOnInteraction & pauseOnMouseEnter
  • add Scrollbar & Scrollbar+Fraction PaginationType

    1.0.x

• 1.0.5 fix renderContentElementPreviewFromFluidTemplate changed parameters
• 1.0.4 change c- to c & improve BE Preview
• 1.0.3 change TCA Config 'slide_content 'according to news configuration 'content_elements'
• 1.0.2 changed deprecated allowTableOnStandardPages() to ignorePageTypeRestriction (https://docs.typo3.org/m/typo3/reference-tca/12.4/en-us/Ctrl/Properties/Security.html#ctrl-security-ignorepagetyperestriction)
• 1.0.1 fix pagination problems with no-pagination JIRA TASK
• 1.0.0 intial from hive_facts