// Copyright (C) 2025 The Qt Company Ltd.
// SPDX-License-Identifier: LicenseRef-Qt-Commercial OR GFDL-1.3-no-invariants-only

/*!
    \page creator-how-to-manage-extensions.html
    \previouspage creator-how-tos.html

    \ingroup creator-how-to-use

    \title Manage extensions

    In \preferences > \uicontrol Extensions > \uicontrol Browse, you can install
    extensions from the \l{\QC extension registry} or from other external
    repositories, as well as activate and deactivate them.

    \image {qtcreator-extension-mode.webp} {Browse tab in Extensions preferences}

    When you \e {install} extensions, they are copied to the correct place on
    the computer and \e {activated} for use. \QC can also \e {load} extensions
    as dependencies of other extensions without explicitly activating them.

    To find extensions, start typing in \uicontrol Search.

    You can sort extensions according to their name or update date.

    To add URLs for installing extensions from external registries
    or to install extensions from installation packages, select
    \imagesettings (\uicontrol {Preferences}) to open the \uicontrol General
    tab.

    \sa {Install extensions}, {Activate extensions}
*/

/*!
    \page creator-how-to-load-extensions.html
    \previouspage creator-how-tos.html

    \ingroup creator-how-to-use

    \title Activate extensions

    In \preferences > \uicontrol Extensions > \uicontrol Browse, you can activate
    installed extensions to use them.

    New extensions are often introduced as \e {experimental extensions} to let
    you try them out before they are fully supported. You must activate them to
    use them. By default, all the extensions that an extension depends on are
    loaded.

    You can also deactivate extensions that you do not use, to streamline \QC.
    If you deactivate an extension, \QC asks you to deactivate all extensions
    that depend on it. This might lead to some features not working properly.
    Further, the extensions are not automatically loaded if you activate the
    first extension again.

    To activate extensions:

    \list 1
        \li Go to \preferences > \uicontrol Extensions > \uicontrol Browse.
            \image {qtcreator-extension-activate.webp} {An extension that has not been loaded}
        \li Select an inactive extension.
        \li Select \uicontrol {Active}.
        \li Select \uicontrol {Restart Now} to restart \QC and load the extension.
    \endlist

    \sa {Install extensions}, {Manage extensions}
*/

/*!
    \page creator-how-to-install-extensions.html
    \previouspage creator-how-tos.html

    \ingroup creator-how-to-use

    \title Install extensions

    You can install compatible extensions either from the
    \l{\QC extension registry} or from other external repositories.

    To install extensions from the extension registry:

    \list 1
        \li Go to \preferences > \uicontrol Extensions > \uicontrol Browse.
            \image {qtcreator-extension-mode.webp} {Browse tab in Extensions preferences}
        \li Select an extension.
        \li Select \uicontrol {Install}.
        \li Follow the instructions of the wizard to check the archive and to
            accept the terms and conditions of the extension vendor.
            \image {qtcreator-extension-check-archive.webp} {Check Archive page of the Install Plugin wizard}
    \endlist

    If you have an installation package, you can drag it to the
    \uicontrol Browse tab to start the installation.

    \section1 Install extensions from external repositories

    To add URLs of external repositories:

    \list 1
        \li Go to \preferences > \uicontrol Extensions > \uicontrol General.
            \image {qtcreator-preferences-extensions.webp} {General tab in Extensions preferences}
        \li Select \uicontrol {Use external repository}.
        \li In \uicontrol {Repository URLs}, enter the URL of an external
            repository.
        \li Select \uicontrol {Apply}.
        \li In the \uicontrol Browse tab, select
            \uicontrol {Use external repository}.
    \endlist

    To add several repositories, select \uicontrol {Add}.

    \section1 Update extensions

    The \uicontrol Browse tab highlights updated extensions. To install
    updates, select \uicontrol {Update}.

    \section1 Remove extensions

    To remove an installed extension, select \uicontrol {Remove}.

    \section1 Security considerations

    \QC does not check extensions from external vendors for security flaws or
    malicious intent, so be careful when installing them, as it might leave your
    computer vulnerable to attacks such as hacking, malware, and phishing.

    Before you install an extension from an external vendor:

    \list
        \li Check that the extension is compatible with your \QC version and
            other extensions that you install. You can find this information in
            the description of the extension in the \uicontrol Browse tab.
        \li Check what other users are saying about the extension and how they
            rate it.
        \li Make sure the vendor is reputable and known for creating high-quality
            extensions.
        \li Check that the extension package was recently updated. Outdated
            extensions present a bigger risk.
        \li Check that the extension has good documentation and other means of
            support.
        \li Check that the extension mostly has features that you need.
            All extensions that are loaded on start make \QC start a bit slower.
    \endlist

    \sa {Activate extensions}, {Manage extensions}
*/
