diff --git a/Documentation/Extensions/HowToFindExtensions.rst b/Documentation/Extensions/HowToFindExtensions.rst new file mode 100644 index 00000000..4c248efe --- /dev/null +++ b/Documentation/Extensions/HowToFindExtensions.rst @@ -0,0 +1,75 @@ +.. include:: /Includes.rst.txt + +.. _how-to-find-extensions: + +====================== +How to find extensions +====================== + +For beginners, finding the right extensions can enhance their TYPO3 experience +significantly. Here is a brief guide on how to search for extensions and where +to find the necessary information. + +#. `TYPO3 Extension Repository (TER) `__ + + The TYPO3 Extension Repository (TER) is an online platform, that hosts + thousands of extensions created by the TYPO3 Community. + Here you can: + + * Search by keyword + * Explore categories + * Filter results + +#. `Packagist `__ + + Packagist serves as the default package repository for PHP packages using Composer, + including TYPO3 extensions. You can search for TYPO3 extensions on Packagist + by entering relevant keywords or filter for extensions to narrow down your + results. Many TYPO3 extensions are available via Composer, which allows for + easier dependency management and installation. This is particularly useful + for developers looking to integrate extensions into their projects. + + +.. _tips-for-choosing-extensions: + +Tips for choosing the right TYPO3 extension +=========================================== + +Selecting the right extension is essential for ensuring that it meets your needs +and integrates well into your TYPO3 setup. Here are a few key factors to consider: + +* Compatibility: + + Verify that the extension is compatible with your version of TYPO3. + The TER and Packagist often display compatibility information. Choosing an + incompatible extension can lead to errors or unexpected issues. + +* Popularity and reviews: + + Extensions that are frequently used and have good reviews are often more + reliable. Look at download numbers, ratings, and user feedback in the TER + or on GitHub to get a sense of the extension’s quality. + +* Support and updates: + + Check if the extension is actively maintained and updated to work with the + latest TYPO3 versions. An extension with recent updates is more likely to + be secure and compatible with modern TYPO3 standards. + +* Documentation: + + Good documentation is essential, especially for beginners. Ensure that the + extension has clear setup and configuration guides, either in the TER, on + the developer's website, or on GitHub. + +* Performance and security: + + Extensions can affect your site’s performance, so choose extensions that + are optimized and well-coded. Additionally, check for any reported security + vulnerabilities, particularly for older extensions, to keep your site secure. + +* Customizability and flexibility: + + If you have specific needs, ensure that the extension is flexible enough to + be customized or configured as required. Some extensions provide PSR-14 events or + APIs, which are beneficial for custom development. diff --git a/Documentation/Extensions/Index.rst b/Documentation/Extensions/Index.rst index a2658a95..6bd5f242 100644 --- a/Documentation/Extensions/Index.rst +++ b/Documentation/Extensions/Index.rst @@ -13,14 +13,13 @@ Working With Extensions :class: pb-4 :card-height: 100 - .. card:: :ref:`Managing Extensions ` + .. card:: :ref:`How to find extensions ` - Information on how to find, install and manage extensions using Composer. + Information on how to find extensions and what to consider when choosing. - .. card:: :ref:`Installing local extensions ` + .. card:: :ref:`Installing Extensions ` - Information on how to install local extensions including site packages and custom - extensions using Composer. + Information on how to install extensions using Composer. .. card:: :ref:`Managing Extensions - Legacy Guide ` @@ -37,7 +36,7 @@ Working With Extensions :hidden: :titlesonly: - Management - Installing Local Extensions + HowToFindExtensions + InstallingExtensions LegacyManagement CreateOwnExtension diff --git a/Documentation/Extensions/Management.rst b/Documentation/Extensions/InstallingExtensions.rst similarity index 98% rename from Documentation/Extensions/Management.rst rename to Documentation/Extensions/InstallingExtensions.rst index 57ce75d2..04e95842 100644 --- a/Documentation/Extensions/Management.rst +++ b/Documentation/Extensions/InstallingExtensions.rst @@ -1,10 +1,10 @@ .. include:: /Includes.rst.txt -.. _extensions_management: +.. _installing-extensions: -=================== -Managing Extensions -=================== +===================== +Installing extensions +===================== Both system extensions and third-party extensions are managed using Composer. Composer handles the installation of the extension and also installs any dependencies that may be @@ -12,9 +12,6 @@ required. Composer is also used to uninstall extensions. .. _install-extension-with-composer: -Installing extensions -===================== - Find the Composer package name for an extension -----------------------------------------------