Metadata-Version: 2.1
Name: odoo-addon-social_media_calendar
Version: 17.0.1.0.0.2
Requires-Python: >=3.10
Requires-Dist: odoo-addon-social_media_base>=17.0dev,<17.1dev
Requires-Dist: odoo>=17.0a,<17.1dev
Summary: Calendar view of the posts, placed on their date and coloured by state
Home-page: https://github.com/OCA/social
License: AGPL-3
Author: Binhex, Odoo Community Association (OCA)
Author-email: support@odoo-community.org
Classifier: Programming Language :: Python
Classifier: Framework :: Odoo
Classifier: Framework :: Odoo :: 17.0
Classifier: License :: OSI Approved :: GNU Affero General Public License v3
Classifier: Development Status :: 4 - Beta
Description-Content-Type: text/x-rst

.. image:: https://odoo-community.org/readme-banner-image
   :target: https://odoo-community.org/get-involved?utm_source=readme
   :alt: Odoo Community Association

=====================
Social Media Calendar
=====================

.. 
   !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
   !! This file is generated by oca-gen-addon-readme !!
   !! changes will be overwritten.                   !!
   !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
   !! source digest: sha256:efedae2f4a9fbd9a5de46b2b7659cb25631fc66b60d66003073810db5697291c
   !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!

.. |badge1| image:: https://img.shields.io/badge/maturity-Beta-yellow.png
    :target: https://odoo-community.org/page/development-status
    :alt: Beta
.. |badge2| image:: https://img.shields.io/badge/license-AGPL--3-blue.png
    :target: http://www.gnu.org/licenses/agpl-3.0-standalone.html
    :alt: License: AGPL-3
.. |badge3| image:: https://img.shields.io/badge/github-OCA%2Fsocial-lightgray.png?logo=github
    :target: https://github.com/OCA/social/tree/17.0/social_media_calendar
    :alt: OCA/social
.. |badge4| image:: https://img.shields.io/badge/weblate-Translate%20me-F47D42.png
    :target: https://translation.odoo-community.org/projects/social-17-0/social-17-0-social_media_calendar
    :alt: Translate me on Weblate
.. |badge5| image:: https://img.shields.io/badge/runboat-Try%20me-875A7B.png
    :target: https://runboat.odoo-community.org/builds?repo=OCA/social&target_branch=17.0
    :alt: Try me on Runboat

|badge1| |badge2| |badge3| |badge4| |badge5|

This module provides the functionality to display posts in the calendar
view.

It is installed automatically together with *Social Media Base*, because
the calendar is meant to be part of the standard experience of the
posts: it adds the calendar view to the Posts menu without any
configuration. Uninstalling it is permanent as long as *Social Media
Base* is not installed again: neither an update of the apps list nor an
upgrade of *Social Media Base* brings the calendar back, but installing
*Social Media Base* again does.

**Table of contents**

.. contents::
   :local:

Usage
=====

Calendar view
-------------

1. Go to Social Media > Posts
2. Click on the Calendar icon to open the calendar view
3. Click on a Post and a popover with its details opens. Its *Edit*
   button opens the post form in a dialog. A draft post can be modified
   and saved there; a planned or a cancelled one has to be taken back to
   draft with the *Draft* button of the form first, and a post that
   already reached one of its accounts keeps its content locked.

Each post is placed on the date it was published; if it has not been
published yet, on its schedule date; and if it is not scheduled, on its
creation date. That is why a scheduled post moves to another day of the
calendar once it is really published.

Posts cannot be rescheduled by dragging them across the calendar: the
date shown is computed from the dates of the post. To change it, open
the post and press *Draft* — a post is planned as soon as a schedule
date is saved, and that date can only be edited while the post is in
draft — and then modify its schedule date.

Deletion is disabled in this view: posts are deleted from the list or
the form.

Colors by publication status
----------------------------

The calendar view will show the posts in different colors depending on
their publication status:

- Draft

  |POST_DRAFT|

- Planned

  |POST_PLANNED|

- Publishing

  |POST_PUBLISHING|

- Partially Published, the post that reached some of its accounts and
  failed on the others

- Published

  |POST_PUBLISHED|

- Cancelled

  |POST_CANCELLED|

- Calendar view by color

  |POSTS_CALENDAR|

Creating a post from the calendar
---------------------------------

Users allowed to create posts can click on an empty day: the post form
opens with *Schedule* selected and 07:00 of that day, in the time zone
of the user, proposed as the schedule date. The accounts and the message
are still required, so the form is the full one, not a quick creation.
Once saved, the post is planned and the scheduler publishes it on that
date.

Whenever that proposal is already behind the clock, a date one hour from
now is proposed instead: this happens on a day already past, and also on
the current day once 07:00 has gone by. A schedule date behind the clock
cannot be saved at all: *Social Media Base* refuses it with a validation
error.

Uninstalling the module
-----------------------

The calendar view is attached to the posts action of *Social Media Base*
through records that belong to *Social Media Calendar*, so Odoo removes
them on uninstall on its own and the Posts menu keeps working with its
kanban, list and form views. The module stays uninstalled afterwards;
only installing *Social Media Base* again brings it back, because it is
auto-installed.

.. |POST_DRAFT| image:: https://raw.githubusercontent.com/OCA/social/17.0/social_media_calendar/static/img/readme/POST_DRAFT.png
.. |POST_PLANNED| image:: https://raw.githubusercontent.com/OCA/social/17.0/social_media_calendar/static/img/readme/POST_PLANNED.png
.. |POST_PUBLISHING| image:: https://raw.githubusercontent.com/OCA/social/17.0/social_media_calendar/static/img/readme/POST_PUBLISHING.png
.. |POST_PUBLISHED| image:: https://raw.githubusercontent.com/OCA/social/17.0/social_media_calendar/static/img/readme/POST_PUBLISHED.png
.. |POST_CANCELLED| image:: https://raw.githubusercontent.com/OCA/social/17.0/social_media_calendar/static/img/readme/POST_CANCELLED.png
.. |POSTS_CALENDAR| image:: https://raw.githubusercontent.com/OCA/social/17.0/social_media_calendar/static/img/readme/POSTS_CALENDAR.png

Bug Tracker
===========

Bugs are tracked on `GitHub Issues <https://github.com/OCA/social/issues>`_.
In case of trouble, please check there if your issue has already been reported.
If you spotted it first, help us to smash it by providing a detailed and welcomed
`feedback <https://github.com/OCA/social/issues/new?body=module:%20social_media_calendar%0Aversion:%2017.0%0A%0A**Steps%20to%20reproduce**%0A-%20...%0A%0A**Current%20behavior**%0A%0A**Expected%20behavior**>`_.

Do not contact contributors directly about support or help with technical issues.

Credits
=======

Authors
-------

* Binhex

Contributors
------------

- `Binhex <https://www.binhex.cloud>`__:

  - Edilio Escalona Almira e.escalona@binhex.cloud

Other credits
-------------

This work has been funded by AEOdoo (Asociación Española de Odoo -
https://www.aeodoo.org)

Maintainers
-----------

This module is maintained by the OCA.

.. image:: https://odoo-community.org/logo.png
   :alt: Odoo Community Association
   :target: https://odoo-community.org

OCA, or the Odoo Community Association, is a nonprofit organization whose
mission is to support the collaborative development of Odoo features and
promote its widespread use.

.. |maintainer-edescalona| image:: https://github.com/edescalona.png?size=40px
    :target: https://github.com/edescalona
    :alt: edescalona

Current `maintainer <https://odoo-community.org/page/maintainer-role>`__:

|maintainer-edescalona| 

This module is part of the `OCA/social <https://github.com/OCA/social/tree/17.0/social_media_calendar>`_ project on GitHub.

You are welcome to contribute. To learn how please visit https://odoo-community.org/page/Contribute.
