lochmueller/portal

Easy to use portal framework with many best practices. Ready to use portal/intranet for TYPO3!

dev-main 2023-10-15 20:13 UTC

Requires

• php: ^8.2
• b13/container: ^2.2
• bk2k/bootstrap-package: ^14.0
• friendsoftypo3/tt-address: ^8.0
• lochmueller/language-detection: ^4.0
• topwrire/topwire: dev-main
• tpwd/ke_search: ^5.0
• typo3/cms-core: ^12.4
• typo3/cms-form: ^12.4
• typo3/cms-reactions: ^12.4
• typo3/cms-webhooks: ^12.4

Requires (Dev)

• friendsofphp/php-cs-fixer: ^3.15
• typo3/testing-framework: 7.x-dev

Suggests

• causal/fal-protect: ^1.2
• evoweb/sf-register: ^10.1
• friendsoftypo3/tt-address: ^5.3
• georgringer/news: ^8.6
• lochmueller/calendarize: ^11.0
• typo3/cms-felogin: ^12.4

Replaces

• typo3-ter/portal: dev-main

GPL-2.0-or-later

• Tim Lochmüller

• portal
• TYPO3 CMS

README

Easy to use portal framework with many best practices.

Integrations

Base

Core (included):

• EXT:felogin (for login process)
• EXT:reactions & EXT:webhooks (for webhook on different user actions)
• EXT:form (for form processes)
• EXT:backend (access all records with regular TYPO3 core functions and usage hte backend user access management)

Third party (included):

• EXT:bootstrap_package (for base styling and theming)
• EXT:container (for flexible grid system on pages)
• EXT:language_detection (for language detection and handling)
• EXT:news (for news handling)
• EXT:tt_address (for contact database)
• EXT:ke_search (for search on fe-group specific data)

Installation

The extension is only available in composer mode, because it is much more flexible, if third party libs have to be included. This example install the portal locally with docker/lando virtualization:

1. Create the composer based TYPO3 project composer create-project typo3/cms-base-distribution:"^12.4" portal
2. Switch to new folder cd portal
3. Install the EXT:portal incl. dependencies composer require lochmueller/portal
4. Copy Lando base file cp vendor/lochmueller/portal/Resources/Private/Build/Lando/.lando.yml .
5. Start lando virtualization lando start
6. Import base DB lando typo3 impexp:import --force-uid --enable-log /app/vendor/lochmueller/portal/Initialisation/data.xml
7. Copy site configuration mkdir -p config/sites/portal && cp vendor/lochmueller/portal/Initialisation/Site/Portal/config.yaml config/sites/portal/config.yaml
8. Create a "Local_Admin1" admin user (password is "Local_Admin1") lando typo3:createLocalAdmin
9. Call https://portal.lndo.site/ & https://portal.lndo.site/typo3/

Credits

Login image:

• https://www.pexels.com/photo/beautiful-view-of-moraine-lake-2662116/

DEV Create new export file

Export: lando typo3 impexp:export --levels=99 --table=_ALL --record=_ALL --title="EXT:portal Export" data

Import: lando typo3 impexp:import --force-uid --enable-log /app/vendor/lochmueller/portal/Initialisation/data.xml

Ideas

• EXT:sf_register (For Registration and edit profile functions)

• EXT:fal_protect (for restrict access to FAL resources)

• EXT:calendarize (Events)

• EXT:news (News)

• EXT:form (Custom Form processes)

• Core Events EXT:reactions

• Add reactions

• Add webhooks

• Theme ideas: https://startbootstrap.com/previews/sb-admin-2

• composer require tpwd/ke_search

• EXT:form registration

• Kickstart Prozess (Wizard)

• EXT:oauth2_client

• https://undraw.co/