API A-Z

The TYPO3 APIs are first and foremost documented inside of the source scripts. It would be impossible to maintain documentation at more than one location given the fact that things change and sometimes fast. This chapter describes the most important elements of the API.

Note

The source is the documentation! (General wisdom)

Contents:

• Assets (CSS, JavaScript, Media)
• Authentication
• Autoloading
  • ComposerClassLoader
• Backend APIs
  • Access control in the backend (users and groups)
    • Users and groups
    • Password reset functionality
    • Roles
    • Access Control Options
    • Other Options
    • More about file mounts
    • Backend users module
  • JavaScript in TYPO3 Backend
    • ES6 in the TYPO3 Backend
    • Client-side templating
    • Various JavaScript modules
      • Modals
      • Multi-step wizard
      • DocumentService (jQuery.ready substitute)
      • SessionStorage wrapper
    • Event API
    • Navigation via JavaScript
    • JavaScript form helpers
  • Ajax in the backend
  • Ajax in the backend, client-side
  • Backend layout
  • Backend routing
  • Backend user object
  • Broadcast channels
  • Button components
  • Clipboard
  • Context-sensitive menus
  • Using Custom Permission Options
  • Links to Edit Records
  • Backend login form API
• Caching
  • Quick start for integrators
  • Configuration
  • Caching framework architecture
  • Cache frontends
  • Cache backends
  • Developer information
• System categories
• Console commands (CLI)
  • Tutorial
• Content Elements & Plugins
  • Introduction
  • Create a custom content element type
  • Custom data processors
  • Create plugins
  • Configure custom backend preview for content element
  • Add content elements to the Content Element Wizard
  • Best practices
• Content Security Policy
• Context API and Aspects
• Country API
• Crop Variants for Images
  • General Configuration
  • Crop variants configuration per content element
• Data Formats
  • T3DataStructure
    • Elements
    • Sheet References
    • Parsing a Data Structure
• Database (Doctrine DBAL)
  • Introduction
  • Configuration
  • Database structure
  • Upgrade table and field definitions
  • Basic create, read, update, and delete operations (CRUD)
  • Class overview
  • ConnectionPool
  • Query builder
  • Connection
  • Expression builder
  • Restriction builder
  • Result
  • Middleware
  • Various tips and tricks
• Debugging
• Dependency injection
• Deprecation
• Directory structure
• Enumerations & bitsets
  • How to use enumerations
  • How to use bitsets
• Environment
• Error and exception handling
  • Configuration
  • Error Handler
  • Production Exception Handler
  • Debug exception handler
  • Examples
  • How to extend the error and exception handling
• Events and hooks
  • Extending the TYPO3 Core
  • Event dispatcher (PSR-14 events)
  • Event list
    • Backend
      • AfterBackendPageRenderEvent
      • AfterFormEnginePageInitializedEvent
      • AfterHistoryRollbackFinishedEvent
      • AfterPageColumnsSelectedForLocalizationEvent
      • AfterPagePreviewUriGeneratedEvent
      • AfterPageTreeItemsPreparedEvent
      • AfterRecordSummaryForLocalizationEvent
      • BeforeFormEnginePageInitializedEvent
      • BeforeHistoryRollbackStartEvent
      • BeforeModuleCreationEvent
      • BeforePagePreviewUriGeneratedEvent
      • BeforeSearchInDatabaseRecordProviderEvent
      • CustomFileControlsEvent
      • IsContentUsedOnPageLayoutEvent
      • IsFileSelectableEvent
      • ModifyAllowedItemsEvent
      • ModifyClearCacheActionsEvent
      • ModifyDatabaseQueryForContentEvent
      • ModifyDatabaseQueryForRecordListingEvent
      • ModifyEditFormUserAccessEvent
      • ModifyFileReferenceControlsEvent
      • ModifyFileReferenceEnabledControlsEvent
      • ModifyGenericBackendMessagesEvent
      • ModifyImageManipulationPreviewUrlEvent
      • ModifyInlineElementControlsEvent
      • ModifyInlineElementEnabledControlsEvent
      • ModifyLinkExplanationEvent
      • ModifyLinkHandlersEvent
      • ModifyNewContentElementWizardItemsEvent
      • ModifyPageLayoutContentEvent
      • ModifyPageLayoutOnLoginProviderSelectionEvent
      • ModifyQueryForLiveSearchEvent
      • ModifyRecordListHeaderColumnsEvent
      • ModifyRecordListRecordActionsEvent
      • ModifyRecordListTableActionsEvent
      • ModifyResultItemInLiveSearchEvent
      • PageContentPreviewRenderingEvent
      • RenderAdditionalContentToRecordListEvent
      • SwitchUserEvent
      • SystemInformationToolbarCollectorEvent
    • Core
      • Authentication
        • AfterGroupsResolvedEvent
        • AfterUserLoggedInEvent
        • AfterUserLoggedOutEvent
        • BeforeRequestTokenProcessedEvent
        • BeforeUserLogoutEvent
        • LoginAttemptFailedEvent
      • Cache
        • CacheFlushEvent
        • CacheWarmupEvent
      • Configuration
        • AfterFlexFormDataStructureIdentifierInitializedEvent
        • AfterFlexFormDataStructureParsedEvent
        • AfterTcaCompilationEvent
        • BeforeFlexFormDataStructureIdentifierInitializedEvent
        • BeforeFlexFormDataStructureParsedEvent
        • ModifyLoadedPageTsConfigEvent
        • SiteConfigurationBeforeWriteEvent
        • SiteConfigurationLoadedEvent
      • Core
        • BootCompletedEvent
      • DataHandling
        • AppendLinkHandlerElementsEvent
        • IsTableExcludedFromReferenceIndexEvent
      • Database
        • AlterTableDefinitionStatementsEvent
      • Domain
        • AfterRecordLanguageOverlayEvent
        • BeforePageLanguageOverlayEvent
        • BeforeRecordLanguageOverlayEvent
        • RecordAccessGrantedEvent
      • Html
        • BrokenLinkAnalysisEvent
      • Mail
        • AfterMailerInitializationEvent
        • AfterMailerSentMessageEvent
        • BeforeMailerSentMessageEvent
      • Package
        • AfterPackageActivationEvent
        • AfterPackageDeactivationEvent
        • BeforePackageActivationEvent
        • PackagesMayHaveChangedEvent
      • Page
        • BeforeJavaScriptsRenderingEvent
        • BeforeStylesheetsRenderingEvent
      • Password policy
        • EnrichPasswordValidationContextDataEvent
      • Resource
        • AfterDefaultUploadFolderWasResolvedEvent
        • AfterFileAddedEvent
        • AfterFileAddedToIndexEvent
        • AfterFileCommandProcessedEvent
        • AfterFileContentsSetEvent
        • AfterFileCopiedEvent
        • AfterFileCreatedEvent
        • AfterFileDeletedEvent
        • AfterFileMarkedAsMissingEvent
        • AfterFileMetaDataCreatedEvent
        • AfterFileMetaDataDeletedEvent
        • AfterFileMetaDataUpdatedEvent
        • AfterFileMovedEvent
        • AfterFileProcessingEvent
        • AfterFileRemovedFromIndexEvent
        • AfterFileRenamedEvent
        • AfterFileReplacedEvent
        • AfterFileUpdatedInIndexEvent
        • AfterFolderAddedEvent
        • AfterFolderCopiedEvent
        • AfterFolderDeletedEvent
        • AfterFolderMovedEvent
        • AfterFolderRenamedEvent
        • AfterResourceStorageInitializationEvent
        • AfterVideoPreviewFetchedEvent
        • BeforeFileAddedEvent
        • BeforeFileContentsSetEvent
        • BeforeFileCopiedEvent
        • BeforeFileCreatedEvent
        • BeforeFileDeletedEvent
        • BeforeFileMovedEvent
        • BeforeFileProcessingEvent
        • BeforeFileRenamedEvent
        • BeforeFileReplacedEvent
        • BeforeFolderAddedEvent
        • BeforeFolderCopiedEvent
        • BeforeFolderDeletedEvent
        • BeforeFolderMovedEvent
        • BeforeFolderRenamedEvent
        • BeforeResourceStorageInitializationEvent
        • EnrichFileMetaDataEvent
        • GeneratePublicUrlForResourceEvent
        • ModifyFileDumpEvent
        • ModifyIconForResourcePropertiesEvent
        • SanitizeFileNameEvent
      • Security
        • InvestigateMutationsEvent
        • PolicyMutatedEvent
      • Tree
        • ModifyTreeDataEvent
      • TypoScript
        • AfterTemplatesHaveBeenDeterminedEvent
        • EvaluateModifierFunctionEvent
    • Extbase
      • Configuration
        • BeforeFlexFormConfigurationOverrideEvent
      • Mvc
        • AfterRequestDispatchedEvent
        • BeforeActionCallEvent
      • Persistence
        • AfterObjectThawedEvent
        • EntityAddedToPersistenceEvent
        • EntityPersistedEvent
        • EntityRemovedFromPersistenceEvent
        • EntityUpdatedInPersistenceEvent
        • ModifyQueryBeforeFetchingObjectDataEvent
        • ModifyResultAfterFetchingObjectDataEvent
    • ExtensionManager
      • AfterExtensionDatabaseContentHasBeenImportedEvent
      • AfterExtensionFilesHaveBeenImportedEvent
      • AfterExtensionStaticDatabaseContentHasBeenImportedEvent
      • AvailableActionsForExtensionEvent
    • Filelist
      • ModifyEditFileFormDataEvent
      • ProcessFileListActionsEvent
    • Frontend
      • AfterCacheableContentIsGeneratedEvent
      • AfterCachedPageIsPersistedEvent
      • AfterLinkIsGeneratedEvent
      • AfterPageAndLanguageIsResolvedEvent
      • AfterPageWithRootLineIsResolvedEvent
      • BeforePageIsResolvedEvent
      • FilterMenuItemsEvent
      • ModifyCacheLifetimeForPageEvent
      • ModifyHrefLangTagsEvent
      • ModifyPageLinkConfigurationEvent
      • ModifyResolvedFrontendGroupsEvent
      • ShouldUseCachedPageDataIfAvailableEvent
    • FrontendLogin
      • BeforeRedirectEvent
      • LoginConfirmedEvent
      • LoginErrorOccurredEvent
      • LogoutConfirmedEvent
      • ModifyLoginFormViewEvent
      • PasswordChangeEvent
      • SendRecoveryEmailEvent
    • Impexp
      • BeforeImportEvent
    • Info
      • ModifyInfoModuleContentEvent
    • Install
      • ModifyLanguagePackRemoteBaseUrlEvent
      • ModifyLanguagePacksEvent
    • Linkvalidator
      • BeforeRecordIsAnalyzedEvent
      • ModifyValidatorTaskEmailEvent
    • Lowlevel
      • ModifyBlindedConfigurationOptionsEvent
    • Redirects
      • AfterAutoCreateRedirectHasBeenPersistedEvent
      • BeforeRedirectMatchDomainEvent
      • ModifyAutoCreateRedirectRecordBeforePersistingEvent
      • ModifyRedirectManagementControllerViewDataEvent
      • RedirectWasHitEvent
      • SlugRedirectChangeItemCreatedEvent
    • Seo
      • ModifyUrlForCanonicalTagEvent
    • Setup
      • AddJavaScriptModulesEvent
    • Workspaces
      • AfterCompiledCacheableDataForWorkspaceEvent
      • AfterDataGeneratedForWorkspaceEvent
      • AfterRecordPublishedEvent
      • GetVersionedDataEvent
      • ModifyVersionDifferencesEvent
      • SortVersionedDataEvent
  • Hooks
  • JavaScript Event API
    • Regular event
    • Debounce event
    • Throttle event
    • RequestAnimationFrame event
• File abstraction layer (FAL)
  • Introduction
  • Basic concepts
  • Architecture
    • Overview
    • Folders
    • Database structure
    • Components
    • PSR-14 Events
  • Administration
    • Permissions
    • File storages
    • Maintenance
  • Using FAL
    • Using FAL in the Frontend
    • TCA Definition
    • The StorageRepository Class
    • Working With files, folders and file references
    • Working With Collections
    • Searching for files
  • File collections
• Custom file processors
• Flash messages
  • Flash messages API
  • Flash messages in Extbase
  • Flash messages renderer
  • JavaScript-based flash messages (Notification API)
• FlexForms
• Fluid
  • Introduction to Fluid
  • Fluid syntax
  • Using Fluid in TYPO3
  • cObject ViewHelper
  • Property additionalAttributes
  • Developing a custom ViewHelper
  • ViewHelper reference
• FormEngine
  • Introduction
  • Main rendering workflow
  • Data compiling
  • Rendering
• Form protection tool
• Global values
  • Constants
• Icon API
• Link handling
  • Link handler configuration
  • LinkBrowser API
  • The LinkHandler API
  • Core link handler
  • Frontend link builder
  • LinkBrowser Tutorials
    • Browse records of a table
    • Create a custom link browser
• Localization
  • Introduction
  • Supported languages
  • Managing translations
  • Translation servers
    • Localization with Crowdin
      • Extension integration
      • Online translation with Crowdin
      • Workflow
      • Frequently asked questions (FAQ)
    • Custom translation servers
  • Localization API
    • LanguageService
    • LanguageServiceFactory
    • Locale
    • LocalizationUtility (Extbase)
  • XLIFF Format
  • Working with XLIFF files
• Locking API
• Logging
  • Quickstart
  • Logger
  • Configuration of the logging system
  • The LogRecord model
  • Log writers
  • Log processors
• Mail API
• Message bus
• Mount points
• Namespaces
• Page types
  • Introduction
  • Types of pages
  • X-Redirect-By header for pages with redirect types
  • Create new Page Type
• Pagination
• Parsing HTML
• Password hashing
  • Troubleshooting
• Password policies
• Request Life Cycle
  • TYPO3 request attributes
    • Application type
    • Current content object
    • Frontend controller
    • Frontend TypoScript
    • Frontend user
    • Language
    • Module
    • ModuleData
    • Nonce
    • Normalized parameters
    • Route
    • Routing
    • Site
    • Target
  • Bootstrapping
  • Middlewares (Request handling)
  • TYPO3 request object
    • Application type
    • Current content object
    • Frontend controller
    • Frontend TypoScript
    • Frontend user
    • Language
    • Nonce
    • Normalized parameters
    • Routing
    • Site
    • Application type
    • Module
    • ModuleData
    • Nonce
    • Normalized parameters
    • Route
    • Site
    • Target
• Routing - "Speaking URLs" in TYPO3
  • Introduction to Routing
  • Page based Routing
  • Advanced routing configuration (for extensions)
  • Extending Routing
  • Collection of various routing examples
• Rich text editors (RTE)
  • CKEditor Rich Text Editor
  • Rendering in the Frontend
  • Rich text editors in the TYPO3 backend
    • Introduction
    • Plugging in a custom RTE
  • Rich Text Editors (RTE) in the TYPO3 frontend
    • Including a Rich Text Editor (RTE) in the frontend
  • RTE Transformations
    • Introduction
    • Transformation overview
  • Historical Perspective on RTE Transformations
    • Properties and Transformations
    • RTE Transformations in Content Elements
• Search engine optimization (SEO)
  • Canonical API
  • MetaTag API
  • Page title API
  • XML sitemap
• Services
  • Introduction
  • Using Services
    • Service precedence
    • Simple usage
    • Use with subtypes
    • Calling a chain of services
  • Configuration
    • Override service registration
    • Service configuration
    • Service type configuration
  • Developer's Guide
    • Introducing a new service type
    • Implementing a service
    • Service API
    • Services API
• Session handling in TYPO3
  • User session management
  • Session storage framework
• Site handling
  • Basics
  • Creating a new site configuration
  • Base variants
  • Adding Languages
  • Error handling
    • Page-based error handler
    • Fluid-based error handler
    • Writing a custom page error handler
  • Writing a custom page error handler
  • Static routes
  • Using environment variables in the site configuration
  • Using site configuration in TypoScript
  • Using site configuration in conditions
  • Using site configuration in TCA foreign_table_where
  • Site settings
  • CLI tools for site handling
  • PHP API: accessing site configuration
  • Extending site configuration
• Soft references
• Symfony expression language
• System registry
• TSFE
• TCE (TYPO3 Core engine) & DataHandler
  • Introduction
  • Database: DataHandler basics (Formerly Known as TCEmain)
  • Using the DataHandler in scripts
  • The "/record/commit" Route
  • File Functions Basics
  • The "tce_file.php" API
• Webhooks and reactions
• Versioning and Workspaces
• XCLASSes (Extending Classes)