extensions.typo3.org

On this page:

The TYPO3 Extension Repository (TER) - the central hub for TYPO3 extensions.

Repository Information

Repository URL: https://git.typo3.org/services/t3o-sites/extensions.typo3.org/ter

Branch Strategy: - Main branch: develop - Feature branches: feature/issue-number-description

Workflow: Follow the standard Workflow

⚠️ Special Access Requirements - Signed NDA required due to GDPR compliance (user data protection) - Standard GitLab access not sufficient - Contact project maintainers for NDA process

Project Description

The TYPO3 Extension Repository provides:

Core Features - Extension registration and management - Extension key management (register, transfer, remove) - Extension uploads and version management - Extension browsing and search functionality - Extension documentation integration - User ratings and reviews - Download statistics and analytics

Target Audience - Extension developers - TYPO3 integrators searching for extensions - Community members exploring available extensions - Extension maintainers managing their extensions

Technical Details

TYPO3 Version: 12.4 LTS PHP Version: 8.1+ Database: MariaDB

Key Extensions - t3olayout: Common layout and styling - filefill: Asset loading from production - solr: Search functionality (required) - ter: Extension repository functionality

⚠️ Solr Requirement This project requires Apache Solr for search functionality. Additional configuration is needed beyond the standard setup.

Local Development Setup

DDEV Setup (Recommended)

Access Check: Ensure you have signed the NDA and have been granted access

Clone the repository:

git clone https://git.typo3.org/services/t3o-sites/extensions.typo3.org/ter.git
cd ter

Configure authentication:

cp auth.json.example auth.json
# Edit auth.json with your GitLab credentials

Start environment:
```
ddev start
ddev sync-database
```
Copied!
Solr Setup: The built-in Solr server starts automatically - Solr Admin: https://extensions.typo3.org.ddev.site:8983 - No additional configuration needed for basic development
Access the site: - Frontend: https://extensions.typo3.org.ddev.site - Backend: https://extensions.typo3.org.ddev.site/typo3/ (admin/password)

Manual Setup

Follow the Manual Setup guide with these additional requirements:

Solr Server Setup - Install Apache Solr 6.6 locally - Configure Solr cores for extension indexing - Set up Solr connection in TYPO3 backend

Database and Configuration - Database dump: URL will be provided later - Filefill configuration: Will be provided later

Solr Configuration

DDEV Environment - Solr runs automatically in Docker container - Pre-configured for development use - Access admin interface at port 8983

Manual Environment - Install Solr 6.6 manually - Configure cores for: - Extension metadata indexing - Extension documentation indexing - Extension code search (if applicable)

Solr Features - Full-text search in extensions - Faceted search by categories, TYPO3 version, etc. - Search suggestions and autocomplete - Advanced search filters

Development Guidelines

Extension Data Management - Extensions are imported from external sources - Local changes may be overwritten during imports - Focus on frontend/backend functionality rather than data

Frontend Development - Build assets: ddev build-frontend (DDEV) - Special attention to search interface - Responsive design for mobile browsing - Performance optimization for large datasets

Search Functionality - Test search with various queries - Verify faceted search filters - Check search result relevance - Test autocomplete functionality

Backend Development - Extension management interfaces - User management for extension developers - Analytics and reporting features - Import/export functionality

Common Development Tasks

Working with Extensions - Extension data is imported, not manually created - Focus on display and search functionality - Test with various extension types and sizes

Search Development - Modify search templates and logic - Update Solr configuration if needed - Test search performance with large datasets - Implement new search features

User Management - Extension developer accounts - Permission management - User registration and verification

Special Considerations

Data Protection (GDPR) - User data handling requires special care - Privacy policy compliance - Data retention policies - User consent management

Performance - Large dataset handling - Search performance optimization - Caching strategies for extension data - Database query optimization

Security - User authentication and authorization - Extension upload security - Input validation and sanitization - Rate limiting for API endpoints

Import Processes - Extension data imports from external sources - Automated synchronization processes - Data validation and cleanup - Error handling for import failures

Known Issues & Solutions

Common Problems - Solr connection issues → Check Solr server status and configuration - Search not working → Verify Solr indexing and core configuration - Import failures → Check data sources and import scripts - Performance issues → Optimize database queries and caching

Development Specific - Large dataset handling → Use pagination and lazy loading - Search relevance → Tune Solr configuration and boost factors - Memory issues → Increase PHP memory limit for large operations

Getting Help

⚠️ Access Issues - Contact project maintainers for NDA process - Ensure your GitLab account matches TYPO3.org username

Technical Support - Project-specific issues: Repository issue tracker - Solr questions: TYPO3 Slack #typo3-solr - General questions: TYPO3 Slack #typo3-org

Resources - TYPO3 Solr documentation: https://docs.typo3.org/c/typo3/cms-solr/ - Apache Solr documentation: https://solr.apache.org/guide/ - Extension development: https://docs.typo3.org/m/typo3/reference-coreapi/

Next Steps

Get NDA Access: Contact maintainers for required documentation
Setup Environment: Local Environment
Understand Workflow: Workflow
Learn Solr: Familiarize yourself with Solr administration
Explore Projects: Projects