[IMP] elearning: clarification content types plus various edits

content/applications/websites/elearning.rst

@@ -15,6 +15,8 @@ learning experience enhances their attentiveness and fosters heightened producti
 .. seealso::
    `Odoo Tutorials: eLearning <https://www.odoo.com/slides/elearning-56>`_
 
+.. _elearning/courses:
+
 Courses
 =======
 
@@ -24,18 +26,19 @@ courses.
 Click on a course title to edit your course on the back end. Click on :guilabel:`View course` to
 access your course on the front end.
 
+.. _elearning/course-creation:
+
 Course creation
 ---------------
 
 Click :guilabel:`New` to create a new course. When the page pops up, you can add your
 :guilabel:`Course Title` and one or more :guilabel:`Tags` to describe your course. You can add an
 image to illustrate your course by hovering your mouse on the camera placeholder image and clicking
-on the edit icon. Four tabs allow you to edit your course further:
+on :icon:`fa-pencil` :guilabel:`(Edit)`. Four tabs allow you to edit your course further:
 :ref:`Content <elearning/content>`, :ref:`Description <elearning/description>`,
 :ref:`Options <elearning/options>`, and :ref:`Karma <elearning/karma>`.
 
 .. image:: elearning/elearning-course-creation.png
-   :align: center
    :alt: Create your elearning course.
 
 .. _elearning/content:
@@ -45,7 +48,7 @@ Content tab
 
 This tab allows you to manage your course content. Click on :guilabel:`Add Section` to divide your
 course into different sections. Click on :guilabel:`Add Content` to create
-:ref:`content <elearning/create-content>`. Click on :guilabel:`Add Certification` to assess the
+:ref:`content <elearning/content-creation>`. Click on :guilabel:`Add Certification` to assess the
 level of understanding of your attendees, certify their skills, and motivate them. **Certification**
 is part of the :doc:`Surveys <../marketing/surveys/create>` app.
 
@@ -58,7 +61,6 @@ You can add a short description or information related to your course in the :gu
 tab. It appears under your course title on your website.
 
 .. image:: elearning/course-description.png
-   :align: center
    :alt: Add a description to your course.
 
 .. _elearning/options:
@@ -67,22 +69,22 @@ Options tab
 ~~~~~~~~~~~
 
 In the :guilabel:`Options` tab, different configurations are available:
-:ref:`Course <elearning/course>`,  :ref:`Communication <elearning/communication>`,
-:ref:`Access rights <elearning/access-rights>`, and :ref:`Display <elearning/display>`.
+:ref:`Course <elearning/options-course>`,  :ref:`Communication <elearning/options-communication>`,
+:ref:`Access rights <elearning/options-access-rights>`, and :ref:`Display
+<elearning/options-display>`.
 
 .. image:: elearning/options-tab.png
-   :align: center
    :alt: Overview of the Options tab
 
-.. _elearning/course:
+.. _elearning/options-course:
 
 Course
 ******
 
 Assign a :guilabel:`Responsible` user for your course. If you have multiple websites, use the
 :guilabel:`Website` field to only display the course on the selected website.
 
-.. _elearning/communication:
+.. _elearning/options-communication:
 
 Communication
 *************
@@ -98,13 +100,13 @@ Communication
   reach the end of your course. Click on the internal link button (:guilabel:`➜`) to access the
   email template editor;
 
-.. _elearning/access-rights:
+.. _elearning/options-access-rights:
 
 Access rights
 *************
 
 - :guilabel:`Prerequisites`: set one or more courses that users are advised to complete before
-   accessing your course;
+  accessing your course;
 - :guilabel:`Show course to`: define who can access your course and their content between
   :guilabel:`Everyone`, :guilabel:`Signed In` or :guilabel:`Course Attendees`;
 - :guilabel:`Enroll Policy`: define how people enroll in your course. Select:
@@ -121,7 +123,7 @@ Access rights
          Only products set up with :guilabel:`Course` as their :guilabel:`Product Type` are
          displayed.
 
-.. _elearning/display:
+.. _elearning/options-display:
 
 Display
 *******
@@ -162,6 +164,8 @@ Course Groups`. Click :guilabel:`New` to create a new course group. Add the :gui
 Name`, tick the :guilabel:`Menu Entry` box to allow users to search by course group on the website,
 and add tags in the :guilabel:`Tag Name` column. For each tag, you can select a corresponding color.
 
+.. _elearning/settings:
+
 Settings
 --------
 
@@ -173,50 +177,103 @@ You can enable different features to customize your courses by going to :menusel
 - **Mailing**: to update all your attendees at once through mass mailings;
 - **Forum**: to create a community and let attendees answer each other's questions.
 
-.. _elearning/create-content:
+.. _elearning/content-creation:
 
 Content
 =======
 
 Manage your content by going to :menuselection:`eLearning --> Courses --> Contents`. Click
 :guilabel:`New` to create content. Add your :guilabel:`Content Title`, and if you want
-:ref:`Tags <elearning/tags>`, then fill in the related information among the different tabs.
+:ref:`Tags <elearning/content-tags>`, then fill in the related information among the different tabs.
 
 .. image:: elearning/elearning-content-tab.png
-   :align: center
    :alt: Create your content.
 
+.. tip::
+
+   You can also create new content from within a course. Go to :menuselection:`eLearning -->
+   Courses`, click the title the relevant course, then click :guilabel:`Add content` at the bottom
+   of the :guilabel:`Content` tab.
+
+.. _elearning/content-document:
+
 Document tab
 ------------
 
-- :guilabel:`Course`: select the course your content belongs to;
-- :guilabel:`Content Type`: select the type of your content;
-- :guilabel:`Responsible`: add a responsible person for your content;
-- :guilabel:`Duration`: indicate the time required to complete the course;
-- :guilabel:`Allow Download`: allow users to download the content of the slide. This option is only
-  visible when the content is a document;
-- :guilabel:`Allow Preview`: the course is accessible by anyone.
-- :guilabel:`# of Public Views`: displays the number of views from non-enrolled participants;
-- :guilabel:`# Total Views`: displays the total number of views (non-enrolled and enrolled
+For each content type, provide the following information:
+
+- :guilabel:`Course`: select the course your content belongs to.
+- :guilabel:`Content Type`: select the relevant :ref:`content type <elearning/content-type>` and
+  provide the required information.
+- :guilabel:`Responsible`: select the user responsible for the content.
+- :guilabel:`Duration`: enter the time required to complete the lesson.
+- :guilabel:`Allow Preview`: enable if the content should be accessible by anyone.
+
+.. note::
+   If the :ref:`Content Type <elearning/content-type>` is :guilabel:`Document`, enabling
+   :guilabel:`Allow Download` allows users to download the content.
+
+Two read-only fields provide data about how often the content item is viewed:
+
+- :guilabel:`# of Public Views` displays the number of views from non-enrolled participants.
+- :guilabel:`# Total Views` displays the total number of views (non-enrolled and enrolled
   participants).
 
+.. image:: elearning/elearning-document-tab.png
+   :alt: Provide information about the content.
+
+.. _elearning/content-type:
+
+Content types
+~~~~~~~~~~~~~
+
+You can add the following content types:
+
+- :guilabel:`Image`: To upload an image, select :guilabel:`Upload from Device`, click
+  :guilabel:`Upload your file`, then select the relevant file. Supported formats include JPG, JPEG,
+  PNG, SVG, GIF, and WEBP. The maximum file size is 25MB.
+
+  Alternatively, to add an image saved in Google Drive, select :guilabel:`Retrieve from Google
+  Drive`, then add the Google Drive link to the image.
+
+- :guilabel:`Article`: Articles are website pages that are :doc:`customized using the website
+  builder </applications/websites/website/web_design>` on your website's front end.
+
+  With the :guilabel:`Course` selected, click the :guilabel:`Go to Website` smart button, then, at
+  the top-right of the screen, click :icon:`fa-pencil` :guilabel:`(Edit)`. Write the article's
+  content and customize the page using the website builder.
+
+- :guilabel:`Document`: To upload a document, select :guilabel:`Upload from Device`, click
+  :guilabel:`Upload your file` then select the relevant file. Only documents in PDF format can be
+  uploaded.
+
+  Alternatively, to add a Google Slides presentation, Google Doc document, or Google Sheets
+  spreadsheet, click :guilabel:`Retrive from Google Drive` and add the Google Drive link to the
+  file.
+
+- :guilabel:`Video`: Add the YouTube, Google Drive, or Vimeo link to the video.
+- :guilabel:`Quiz`: Open the :ref:`Quiz tab <elearning/content-quiz>` to create a quiz.
+
+.. _elearning/content-description:
+
 Description tab
 ---------------
 
 You can add a description of your content that appears front end in the :guilabel:`About` section of
 your course content.
 
+.. _elearning/content-additional-resources:
+
 Additional Resources tab
 ------------------------
 
 Click :guilabel:`Add a line` to add a link or a file that supports your participants' learning.
 It appears in the course content on your website.
 
 .. image:: elearning/additional-content.png
-  :align: center
   :alt: Additional ressources
 
-.. _elearning/quiz:
+.. _elearning/content-quiz:
 
 Quiz tab
 --------
@@ -231,7 +288,7 @@ line`. Tick the :guilabel:`Is correct answer` to mark one or more answers as cor
 fill in the :guilabel:`Comment` field to display additional information when the answer is chosen by
 the participant.
 
-.. _elearning/tags:
+.. _elearning/content-tags:
 
 Content Tags
 ------------
@@ -241,16 +298,33 @@ The **Content Tags** help users to classify the content from the :guilabel:`Cont
 You can manage them by going to :menuselection:`eLearning --> Configuration --> Content Tags`. Click
 :guilabel:`New` to create a new tag.
 
-Publish your content
-====================
+.. _elearning/publish-content:
 
-Everything created on the back end needs to be published from the front end. Unpublished content is
-always visible from your website but still needs to be published to be available to your audience.
+Publish courses and content
+===========================
 
-You must be on your website's front end to publish your content. To do so, click on the
-:guilabel:`Go To Website` smart button, and tick the :guilabel:`Publish` option available in the
-right-hand corner.
+Courses and content need to be published from the front end. Unpublished courses and content are
+always visible from your website but still need to be published to be available to your audience.
+
+To access the front end, click the :guilabel:`Go to Website` smart button at the top the course page
+or an individual content page.
+
+A course and its content are published separately:
+
+- To publish a course, on the main course page, toggle the switch in the upper-right corner from
+  :guilabel:`Unpublished` to :guilabel:`Published`.
+- To publish individual content items, click on an item to open it, then toggle the switch
+  from :guilabel:`Unpublished` to :guilabel:`Published`.
 
 .. image:: elearning/elearning-publish-button.png
-  :align: center
   :alt: Publish your content.
+
+.. tip::
+   When publishing a new course, publish the individual content items before publishing the course
+   itself. Published content is only available to your audience once the course is published.
+
+Unpublishing a course, i.e., by toggling the switch in the upper-right corner of the main course
+page from :guilabel:`Published` to :guilabel:`Unpublished` renders the course and its content
+unavailable to your audience.
+
+

content/applications/websites/forum.rst

@@ -54,7 +54,7 @@ having moderator rights. They are also used to set user :ref:`ranks <forum/ranks
 .. important::
    - A user's karma points are shared across all forums, courses, etc., of a single Odoo website.
    - eLearning users can earn karma points through different :ref:`course interactions
-     <elearning/karma>` and by :ref:`completing quizzes <elearning/quiz>`.
+     <elearning/karma>` and by :ref:`completing quizzes <elearning/content-quiz>`.
 
 .. _forum/karma-gains: