diff --git a/admin_manual/installation/apps_management_installation.rst b/admin_manual/installation/apps_management_installation.rst index 597fa0db1..b054355ba 100644 --- a/admin_manual/installation/apps_management_installation.rst +++ b/admin_manual/installation/apps_management_installation.rst @@ -2,55 +2,64 @@ Installing and managing apps ============================ -After installing Nextcloud, you may provide added functionality by installing -applications. +Nextcloud apps can enhance, customize or even restrict the features and experience +you and your users has with the Nextcloud server. Next to default enabled functions +like Files, Activity and Gallery there are other apps like Calendar, Contacts, +Talk and more which are enhancing the features of your Nextcloud server. -Supported apps --------------- +After installing the Nextcloud server, you might want to consider about enabling, +disabling or even restricting some apps to groups depending on your and your users +needs. -See :doc:`apps_supported` for a list of supported apps. +Apps management +--------------- -Viewing enabled apps --------------------- - -During the Nextcloud installation, some apps are enabled by default. To see which -apps are enabled go to your Apps page. - -.. figure:: ../images/oc_admin_app_page.png +.. figure:: /images/apps_overview.png :alt: Apps page for enabling and disabling apps. -You will see which apps are enabled, not enabled, and recommended. You'll also -see additional filters, such as Multimedia, Productivity, and Tool for finding -more apps quickly. +During the Nextcloud server installation, some apps are enabled by default. +To see which apps are enabled go to your Apps page. + +Those apps are supported and developed by Nextcloud GmbH directly and +have an **Official**-tag. See :doc:`apps_supported` for a list of supported apps. + +.. note:: To get access to work-arounds, long-term-support, priority bug fixing + and custom consulting for supported apps, contact our `sales team `_. + +Apps with **Approved** tag are community-developed and were uploaded in the +`Nextcloud App Store `_. + +.. note:: If you would like to develop your own Nextcloud app, you can find out + more information in our `developer manual `_. +.. TODO ON RELEASE: Update version number above on release + +All apps need to be licensed under AGPLv3+ or any compatible license. Managing apps ------------- +.. figure:: /images/apps_store.png + :alt: App store page for installing, enabling and disabling apps. + +You will see which apps are enabled, disabled and available. You'll also +see additional app bundles and filters, such as Customization, Security and +Monitoring for finding more apps quickly. + In the Apps page you can enable or disable applications. Some apps have configurable options on the Apps page, such as **Enable only for specific -groups**, but mainly they are enabled or disabled here, and are configured on -your Nextcloud Admin page, Personal page, or in ``config.php``. +groups**, but mainly they are enabled or disabled here, and are configured in +your Nextcloud settings (admin and/or user-settings) or in the ``config.php``. -Adding third party apps ------------------------ +Click the app name to view a description of the app and any of the app settings +in the Application View field. Clicking the **Enable** button will enable the app. +If the app is not part of the Nextcloud installation, it will be downloaded from +the app store, installed and enabled. -Some apps are developed and supported by Nextcloud directly. These have an -**Official** tag. Apps with the **Approved** tag are community-developed and -supported; they are maintained by trusted developers, and are under active -development. Only **Official** and **Approved** apps are linked on the Apps -page by default. +Using private API +----------------- -Click the app name to view a description of the app and any of the app settings in the Application View field. Clicking the **Enable** button will enable the app. If the app is not part of the Nextcloud installation, it will be downloaded from the app store, installed and enabled. - -Sometimes the installation of a third-party app fails silently, possibly because -``'appcodechecker' => true,`` is enabled in ``config.php``. When ``appcodechecker`` is -enabled it checks if third-party apps are using the private API, rather than the public -API. If they are then they will not be installed. - -.. note:: If you would like to create or add your own Nextcloud app, please - refer to the `developer manual - `_. -.. TODO ON RELEASE: Update version number above on release +If private API, rather than the public APIs are used in a third-party app, the +installation fails, if ``'appcodechecker' => true,`` is set in ``config.php``. Using custom app directories ---------------------------- diff --git a/admin_manual/installation/images/apps_overview.png b/admin_manual/installation/images/apps_overview.png new file mode 100644 index 000000000..0dbde6f67 Binary files /dev/null and b/admin_manual/installation/images/apps_overview.png differ diff --git a/admin_manual/installation/images/apps_store.png b/admin_manual/installation/images/apps_store.png new file mode 100644 index 000000000..1bc57fda6 Binary files /dev/null and b/admin_manual/installation/images/apps_store.png differ