documentation/content/applications/general.rst
2021-06-25 15:59:04 +02:00

185 lines
6.4 KiB
ReStructuredText
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

:show-content:
=======
General
=======
.. toctree::
general/users
general/export_import_data
general/multi_companies
general/auth
general/payment_acquirers
general/voip
general/calendars
general/in_app_purchase
general/unsplash
**Odoo** is a suite of open source business apps that cover all your company needs: :doc:`CRM
<sales/crm>`, :doc:`eCommerce <websites/ecommerce>`, :doc:`accounting <finance/accounting>`,
:doc:`inventory <inventory_and_mrp/inventory>`, :doc:`point of sale <sales/point_of_sale>`,
:doc:`project management <services/project>`, etc. Its unique value proposition is to be at the same
time *very easy* to use and *fully integrated*.
This section of the documentation covers all functional aspects that aren't app-specific. You can
find, for example, information about:
- :doc:`general/users` and :doc:`general/users/access_rights`, to configure each user correctly.
- :doc:`general/export_import_data`, to transfer data from and to other environments than Odoo or
update data.
- :doc:`general/payment_acquirers`, to allow your customers to pay with their favorite payment
method.
- :doc:`general/auth/google`, as an authentication method.
.. important::
- | **Installing or uninstalling apps, managing users, etc., is up to you.**
| As the administrator of your database, you are responsible for its usage, as you know best
how your organization works. This includes the installation or uninstallation of :ref:`apps
<general/apps-modules>` as well as the number of :doc:`users <general/users>` currently in
use.
- | **Odoo apps have dependencies.**
| Installing some apps and features with dependencies may also install additional apps and
modules that are technically required, even if you won't actively use them.
- | **Always test app installation/removal on a duplicate of your database.**
| This way, you can know what app dependencies may be required or what data may be erased.
.. seealso::
- :ref:`Online Database management: Duplicate a database <duplicate_online>`
- :ref:`On-premises Database management: Duplicate a database <duplicate_premise>`
- `Submit a Support Ticket <https://www.odoo.com/help>`_
.. _general/apps-modules:
Apps and modules
================
You can :ref:`install <general/install>`, :ref:`upgrade <general/upgrade>` and :ref:`uninstall
<general/uninstall>` all apps and modules from the :menuselection:`Apps` dashboard.
By default, an *Apps* filter is applied. If you want to search for modules (including :doc:`Fiscal
Localization Packages
<finance/accounting/fiscal_localizations/overview/fiscal_localization_packages>`), click on
*Filters* and select *Extra*.
.. image:: general/apps-search-filter.png
:align: center
:alt: Add "Extra" filter in Odoo Apps
.. warning::
Odoo is *not a smartphone*, and its apps shouldn't be installed or uninstalled carelessly. Apply
caution when adding or removing apps and modules on your database since this may impact your
subscription costs.
.. _general/install:
Install apps and modules
------------------------
Go to :menuselection:`Apps`, and click on the *Install* button of the app you want to install.
.. note::
If the module you are looking for is not listed, you can **update the app list**.
To do so, activate the :ref:`developer mode <developer-mode>`, then go to :menuselection:`Apps
--> Update Apps List` and click on *Update*.
.. _general/upgrade:
Upgrade apps and modules
------------------------
On some occasions, new improvements or app features are added to :doc:`supported versions of Odoo
</services/support/supported_versions>`. To be able to use them, you must **upgrade** your app.
Go to :menuselection:`Apps`, click on the *dropdown menu* of the app you want to upgrade, then on
*Upgrade*.
.. _general/uninstall:
Uninstall apps and modules
--------------------------
Go to :menuselection:`Apps`, click on the *dropdown menu* of the app you want to uninstall, then on
*Uninstall*.
.. image:: general/uninstall.png
:align: center
Some apps have dependencies, meaning that one app requires another. Therefore, uninstalling one app
may uninstall multiple apps and modules. Odoo warns you which dependant apps and modules are
affected by it.
.. image:: general/uninstall_deps.png
:align: center
To complete the uninstallation, click on *Confirm*.
.. danger::
Uninstalling an app also uninstalls all its dependencies and permanently erases their data.
.. _developer-mode:
Activate the developer mode (debug mode)
========================================
The developer mode (or debug mode) gives you access to extra and advanced tools.
Through the Settings
--------------------
Go to :menuselection:`Settings --> Activate the developer mode`.
.. image:: general/settings.png
:align: center
:alt: Overview of the debug options under settings in Odoo
.. note::
*Activate the developer mode (with assets)* is used by developers; *Activate the developer mode
(with tests assets)* is used by developers and testers.
Once activated, the *Deactivate the developer mode* option becomes available.
Through a browser extension
---------------------------
| Go to the settings and extensions of your web browser, and search for *Odoo Debug*. Once the
extension is installed, a new icon will be shown on your toolbar.
| For the *Odoo Debug* extension, a single click enables a normal version of the mode, while a
double click enables it with assets. To deactivate it, use a single click.
.. image:: general/monkey.png
:align: center
:alt: View of odoos debug icon in a chromes toolbar
Through the URL
---------------
In the URL add ``?debug=1`` or ``?debug=true`` after *web*.
.. image:: general/url.png
:align: center
:alt: Overview of an url with the debug mode command added in Odoo
.. tip::
Developers: type ``?debug=assets`` and activate the mode with assets.
Locate the mode tools
---------------------
The Developer mode tools can be accessed from the *Open Developer Tools* button, located on the
header of your pages.
.. image:: general/button_location.png
:align: center
:alt: Overview of a console page and the debug icon being shown in Odoo
Mobile Push Notifications
=========================
As of Odoo 12.0, 13.0 or above, there is no more complex configuration to enable push
notifications in the mobile app.
Simply go to :menuselection:`Settings --> General Settings --> Odoo Cloud Notification (OCN)`
and make sure that **Push Notifications** is checked.