[ADD] Recruitment: Post Job Positions

Author: larm-odoo

content/applications/hr/recruitment.rst

@@ -35,31 +35,6 @@ app. To view and edit the settings, navigate to :menuselection:`Recruitment app
 --> Settings`. After any changes are made, click the :guilabel:`Save` button in the top-left corner
 to save all the changes.
 
-Job posting
------------
-
-The :guilabel:`Job Posting` section of the **Recruitment** app settings has two configurations,
-enabling posting jobs on the company website, and on external job boards.
-
-If job positions are to be posted to the company's website, enable the :guilabel:`Online Posting`
-option.
-
-.. note::
-   The :guilabel:`Online Posting` is only available if the :doc:`Website <../websites/website>`
-   application is also installed.
-
-The **Recruitment** app can post job positions directly to a job board. To enable this, click
-:icon:`oi-arrow-right` :guilabel:`Choose a Job Board`, and the required module is presented, if not
-already installed. Click :guilabel:`Install` on the corresponding module, then the main Odoo
-dashboard loads after a successful installation.
-
-Open the **Recruitment** app, and navigate to :menuselection:`Recruitment app --> Configuration -->
-Settings`. The corresponding job board credentials are listed. Enter the :guilabel:`Username` and
-:guilabel:`Password` for the job board. Click the :guilabel:`Save` button after making any changes.
-
-.. note::
-   Currently, the only job board integration with Odoo is Monster.com.
-
 Process
 -------
 
@@ -387,6 +362,7 @@ appears in the chatter.
 
 .. seealso::
    - :doc:`recruitment/new_job`
+   - :doc:`recruitment/post_job`
    - :doc:`recruitment/add-new-applicants`
    - :doc:`recruitment/schedule_interviews`
    - :doc:`recruitment/offer_job_positions`
@@ -400,6 +376,7 @@ appears in the chatter.
    :titlesonly:
 
    recruitment/new_job
+   recruitment/post_job
    recruitment/recruitment-flow
    recruitment/add-new-applicants
    recruitment/schedule_interviews

content/applications/hr/recruitment/new_job.rst

@@ -51,12 +51,6 @@ card to reveal several options, and then click :guilabel:`Configuration` to edit
 .. image:: new_job/edit-job.png
    :alt: Edit the job position card.
 
-.. note::
-   The top-right corner of the card has a toggle to publish the job position to the website. If the
-   job position is published, a green :guilabel:`Published` toggle is visible. If the job position
-   is *not* published a gray :guilabel:`Not Published` toggle appears. Click the toggle to publish
-   or unpublish the job position.
-
 Recruitment tab
 ~~~~~~~~~~~~~~~
 

content/applications/hr/recruitment/post_job.rst

@@ -0,0 +1,128 @@
+==================
+Post job positions
+==================
+
+Once a job position has been :doc:`cretaed and configured <new_job>`, the next step is to share the
+job position, so that prospective applicants can apply.
+
+Job positions can be shared on the :ref:`company website <post-job/website>` or on :ref:`job boards
+<post-job/boards>`.
+
+.. _post-job/website:
+
+Publish to website
+==================
+
+To publish a job listing on the company's website, first a setting must be enabled in the
+**Recruitment** app. Navigate to :menuselection:`Recruitment app --> Configuration --> Settings`,
+and enable the :guilabel:`Online Posting` option. Click the :guilabel:`Save` button after making any
+changes.
+
+.. note::
+   The :guilabel:`Online Posting` is only available if the :doc:`Website <../../websites/website>`
+   application is also installed.
+
+Once the setting has been enabled, open the main **Recruitment** dashboard by navigating to
+:menuselection:`Recruitment app --> Applications --> By Job Positiosn`. A toggle appears in the
+lower-left corner of every job position card, and displays either :guilabel:`Not Publused` or
+:guilabel:`Published`.
+
+Click on the toggle to change the current state of the job position. When a job position is
+published, a green :guilabel:`PUBLISHED` banner appears in the topr-right corner of the card.
+
+To view the listing on the website, click the :icon:`oi-launch` :guilabel:`Job Page` in the
+lower-right corner of the job card.
+
+.. _post-job/boards:
+
+Post on job boards
+==================
+
+Posting a job onto a job board is an effective way to reach a wider audience, and attract more
+candidates. Currently, Odoo only has the capability to post to Monster.com, but check back for more
+updates as more job boards are added.
+
+Job board settings
+------------------
+
+Publishing a job listing onto a job board, first a setting must be configured in the **Recruitment**
+app. Navigate to :menuselection:`Recruitment app --> Configuration --> Settings`, and click
+:icon:`oi-arrow-right` :guilabel:`Choose a Job Board`.
+
+This loads a page displaying the :guilabel:`Recruitment Integration Monster` module. Click
+:guilabel:`Activate` to install the module.
+
+.. note::
+   If the :guilabel:`Recruitment Integration Monster` module is already installed, no
+   :guilabel:`Activate` button appears, only a :guilabel:`Module Info` button.
+
+Once the module is installed, the database reloads to the main dashboard. Open the **Recruitment**
+app, and navigate to :menuselection:`Configuration --> Settings`. A :guilabel:`Monster Credentials`
+section appears in the :guilabel:`Job Posting` section.
+
+Enter the :guilabel:`Username` and :guilabel:`Password` for Monster in the corresponding fields,
+then click the :guilabel:`Save` button.
+
+Publish on job board
+--------------------
+
+Once the credentials have been configured for the job board, it is possible to post a job position.
+Navigate to the **Recruitment** app dashboard, and click :guilabel:`# To Recruit` on the desired
+job card.
+
+Click the :guilabel:`Publish on Job Board` button, and a :guilabel:`Publish on Job Board` form loads
+in a pop-up window. Fill out the following information on the form:
+
+- :guilabel:`Job`: The name of the job position appears here by default, and cannot be modified.
+- :guilabel:`Job Board`: Using the drop-down menu, select the job board being posted to.
+- :guilabel:`Apply Method`: Click the desired radio button to determine how applicants apply for the
+  position.
+
+  - :guilabel:`Send an Email`: Select this for applicants to apply for the job via email.
+  - :guilabel:`Redirect to company's website`: Select this for applicants to apply for the job via
+    the company website.
+
+- :guilabel:`Email` or :guilabel:`Job url`: The selected :guilabel:`Apply Method` determines which
+  field appears. The field is populated with the information from the job card, if available. Make
+  any desired modifications to this field, for example enter a tracking url for the job board
+  listing.
+- :guilabel:`From` and :guilabel:`to`: Using the calendar selector, select the date the list should
+  be posted to the job board, in the :guilabel:`From` field. The :guilabel:`to` field says
+  :guilabel:`No Limit`, by default. If the job position should be removed from the job board on a
+  specific date, enter it in the second field.
+- :guilabel:`Descriotion` tab: The description from the job card populates this tab, by default.
+  Make any desired changes to it in this section. This is what appears on the job board.
+
+  .. tip::
+     Click the :guilabel:`Generate Description` (:icon:`fa-magic` :guilabel:`AI`) to use AI to edit
+     or create the job description.
+
+Once the listing is ready, click the :guilabel:`Post` button. After the post has been published to a
+job board, the page reloads to the :guilabel:`Job Boards Posts` page, and the new post appears in a
+Kanban card.
+
+.. image:: post_job/job-board.png
+   :alt: A job board listing form filled out.
+
+Job board emails
+~~~~~~~~~~~~~~~~
+
+
+
+
+View job board listings
+-----------------------
+
+To view all the job positions that have been posted to a job board, navigate to
+:menuselection:`Recruitment --> Applications --> Job Boards Posts`. This presents the :guilabel:`Job
+Boards Posts` dashboard and all job board postings.
+
+Each listing is displayed in an individual Kanban card, with the following information:
+
+- :guilabel:`Job Board Icon`: the icon for the job board the listing is posted on
+- :guilabel:`Job Board Listing Title`: the job position title and job board name
+- :guilabel:`From`: the date the listing was published
+- :guilabel:`To`: the date the listing will be removed from the job board.
+- :guilabel:`User Icon`: the icon of the user who posted the listing.
+
+Click on any Kanban card to view the details for the specific job board listing.