Merge branch 'main' into feature/recommended-extensions

linawolf · web-flow · commit 6532f25caf26 · 2024-11-06T14:18:23.000+01:00
diff --git a/Documentation/Extensions/HowToFindExtensions.rst 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) <https://extensions.typo3.org/>`__
+
+    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 <https://packagist.org//>`__
+
+    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
@@ -13,37 +13,27 @@ Working With Extensions
     :class: pb-4
     :card-height: 100
 
-    ..  card:: :ref:`Managing Extensions <extensions_management>`
+    ..  card:: :ref:`How to find extensions <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 <install_local_extensions_using_composer>`
+    ..  card:: :ref:`Installing Extensions <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 <extensions_legacy_management>`
+    ..  card:: :ref:`Recommended extensions <recommended-extensions>`
 
-        This guide contains information on how to manage extensions using the
-        TYPO3 backend and the TYPO3 Extension Repository (TER) without Composer.
-        This method of managing extensions is now deprecated.
+        An overview of recommended extensions.
 
     ..  card:: :ref:`Create your own extension <create-own-extension>`
 
         This guide contains information on how to create your own extension.
 
-    ..  card:: :ref:`Recommended extensions <recommended-extensions>`
-
-        An overview of recommended extensions.
-
-
 ..  toctree::
     :hidden:
     :titlesonly:
 
-    Management
-    Installing Local Extensions <https://docs.typo3.org/m/typo3/tutorial-getting-started/main/en-us/Extensions/Management.html#installing-local-extensions>
-    LegacyManagement
-    CreateOwnExtension
+    HowToFindExtensions
+    InstallingExtensions
     RecommendedExtensions
-
+    CreateOwnExtension
diff --git a/Documentation/Extensions/InstallingExtensions.rst b/Documentation/Extensions/InstallingExtensions.rst
@@ -1,20 +1,17 @@
 .. 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
 required. Composer is also used to uninstall extensions.
 
 .. _install-extension-with-composer:
 
-Installing extensions
-=====================
-
 Find the Composer package name for an extension
 -----------------------------------------------
 
diff --git a/Documentation/Extensions/LegacyManagement.rst b/Documentation/Extensions/LegacyManagement.rst
diff --git a/Documentation/FirstProject/CreateSitePackage.rst b/Documentation/FirstProject/CreateSitePackage.rst
@@ -0,0 +1,47 @@
+..  include:: /Includes.rst.txt
+
+..  _creating-a-site-package:
+
+=======================
+Creating a site package
+=======================
+
+The next step is to create a site package. In TYPO3, a site package is a
+structured package that organizes the layout, design, and essential
+configuration settings for your website. By using a site package, you can
+manage all customizations in one place, which keeps your changes organized and
+makes your project easier to maintain, even through TYPO3 updates.
+
+..  _how-to-create-a-site-package:
+
+How to create a site package
+============================
+
+To create a site package, you have two main options:
+
+*   Manual creation: For full control over your project's setup, you can follow
+    the detailed instructions int the
+    :ref:`TYPO3 site package tutorial <t3sitepackage:start>`.
+
+*   Using the `Sitepackage-Builder <https://www.sitepackagebuilder.com/>`__:
+    If you are looking for a faster start, the Sitepackage-Builder is a
+    handy tool. You can choose whether your site package should be based on
+    the `Bootstrap Package <https://www.bootstrap-package.com/>`__ or
+    :ref:`fluid_styled_content <typo3/cms-fluid-styled-content:introduction>`.
+
+
+..  _pros-and-cons-of-sitepackage-builder:
+
+Pros and cons of using the Sitepackage-Builder
+==============================================
+
+Pros:
+
+*   The Sitepackage-Builder is particularly useful for beginners or projects
+    that need a quick start.
+
+Cons:
+
+*   A large number of unnecessary, mostly empty files are being generated.
+*   Depending on your prior knowledge you use code that you might not fully
+    understand.
diff --git a/Documentation/FirstProject/Index.rst b/Documentation/FirstProject/Index.rst
@@ -47,6 +47,13 @@ First project setup
         ..  card-footer:: :ref:`Manage settings <settings>`
             :button-style: btn btn-secondary stretched-link
 
+    ..  card:: :ref:`Creating a site package <creating-a-site-package>`
+
+        Next steps after setting up your first project.
+
+        ..  card-footer:: :ref:`Creating a site package <creating-a-site-package>`
+            :button-style: btn btn-secondary stretched-link
+
 ..  toctree::
     :hidden:
     :titlesonly:
@@ -55,3 +62,4 @@ First project setup
     SiteManagement/Index
     IntroductionPackage/Index
     Settings
+    CreateSitePackage
