Skip to content
Draft
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
196 changes: 196 additions & 0 deletions social_media_calendar/README.rst
Original file line number Diff line number Diff line change
@@ -0,0 +1,196 @@
=====================
Social Media Calendar
=====================

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

.. |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/licence-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, where it can be modified and
saved.

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 modify its schedule date.

Deletion is the only action 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

Known issues / Roadmap
======================

This module, like the rest of the *Social Media* family, is not
compatible with the ``social`` module of Odoo Enterprise: both define
the same model names (``social.post``, ``social.account``,
``social.media``). The incompatibility is declared in the manifest of
*Social Media Base* with ``"excludes": ["social"]``, so Odoo refuses the
installation with an error if the ``social`` module of Enterprise is
already installed in the database, and the other way round.

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
-------

* BinhexTeam

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

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

- Edilio Escalona Almira e.escalona@binhex.cloud

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.
4 changes: 4 additions & 0 deletions social_media_calendar/__init__.py
Original file line number Diff line number Diff line change
@@ -0,0 +1,4 @@
# Copyright 2025 Binhex <https://www.binhex.cloud>
# License AGPL-3.0 or later (https://www.gnu.org/licenses/agpl).

from . import models
24 changes: 24 additions & 0 deletions social_media_calendar/__manifest__.py
Original file line number Diff line number Diff line change
@@ -0,0 +1,24 @@
# Copyright 2025 Binhex <https://www.binhex.cloud>
# License AGPL-3.0 or later (https://www.gnu.org/licenses/agpl).
{
"name": "Social Media Calendar",
"summary": "Module for social media calendar integration.",
"version": "17.0.1.0.0",
"category": "Social Network",
"development_status": "Beta",
"license": "AGPL-3",
"author": "BinhexTeam,Odoo Community Association (OCA)",
"website": "https://github.com/OCA/social",
"maintainers": ["edescalona"],
"depends": ["social_media_base"],
"data": [
"views/social_post_views.xml",
],
"assets": {
"web.assets_backend": [
"social_media_calendar/static/src/js/views/**/*.js",
],
},
"auto_install": True,
"installable": True,
}
44 changes: 44 additions & 0 deletions social_media_calendar/i18n/es.po
Original file line number Diff line number Diff line change
@@ -0,0 +1,44 @@
# Translation of Odoo Server.
# This file contains the translation of the following modules:
# * social_media_calendar
#
msgid ""
msgstr ""
"Project-Id-Version: Odoo Server 17.0\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2026-08-10 16:21+0000\n"
"PO-Revision-Date: 2026-08-10 16:21+0000\n"
"Last-Translator: \n"
"Language-Team: \n"
"Language: es\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=UTF-8\n"
"Content-Transfer-Encoding: \n"
"Plural-Forms: \n"

#. module: social_media_calendar
#: model:ir.model.fields,field_description:social_media_calendar.field_social_post__color
msgid "Color"
msgstr "Color"

#. module: social_media_calendar
#: model:ir.model.fields,field_description:social_media_calendar.field_social_post__date_calendar
msgid "Date Calendar"
msgstr "Fecha en el calendario"

#. module: social_media_calendar
#. odoo-javascript
#: code:addons/social_media_calendar/static/src/js/views/calendar/social_calendar_controller.esm.js:0
#, python-format
msgid "New Post"
msgstr "Nueva publicación"

#. module: social_media_calendar
#: model:ir.model,name:social_media_calendar.model_social_post
msgid "Social Post"
msgstr "Publicación social"

#. module: social_media_calendar
#: model_terms:ir.ui.view,arch_db:social_media_calendar.social_post_view_calendar
msgid "Social Posts"
msgstr "Publicaciones sociales"
44 changes: 44 additions & 0 deletions social_media_calendar/i18n/es_ES.po
Original file line number Diff line number Diff line change
@@ -0,0 +1,44 @@
# Translation of Odoo Server.
# This file contains the translation of the following modules:
# * social_media_calendar
#
msgid ""
msgstr ""
"Project-Id-Version: Odoo Server 17.0\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2026-08-10 16:21+0000\n"
"PO-Revision-Date: 2026-08-10 16:21+0000\n"
"Last-Translator: \n"
"Language-Team: \n"
"Language: es_ES\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=UTF-8\n"
"Content-Transfer-Encoding: \n"
"Plural-Forms: \n"

#. module: social_media_calendar
#: model:ir.model.fields,field_description:social_media_calendar.field_social_post__color
msgid "Color"
msgstr "Color"

#. module: social_media_calendar
#: model:ir.model.fields,field_description:social_media_calendar.field_social_post__date_calendar
msgid "Date Calendar"
msgstr "Fecha en el calendario"

#. module: social_media_calendar
#. odoo-javascript
#: code:addons/social_media_calendar/static/src/js/views/calendar/social_calendar_controller.esm.js:0
#, python-format
msgid "New Post"
msgstr "Nueva publicación"

#. module: social_media_calendar
#: model:ir.model,name:social_media_calendar.model_social_post
msgid "Social Post"
msgstr "Publicación social"

#. module: social_media_calendar
#: model_terms:ir.ui.view,arch_db:social_media_calendar.social_post_view_calendar
msgid "Social Posts"
msgstr "Publicaciones sociales"
43 changes: 43 additions & 0 deletions social_media_calendar/i18n/social_media_calendar.pot
Original file line number Diff line number Diff line change
@@ -0,0 +1,43 @@
# Translation of Odoo Server.
# This file contains the translation of the following modules:
# * social_media_calendar
#
msgid ""
msgstr ""
"Project-Id-Version: Odoo Server 17.0\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2026-08-10 16:21+0000\n"
"PO-Revision-Date: 2026-08-10 16:21+0000\n"
"Last-Translator: \n"
"Language-Team: \n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=UTF-8\n"
"Content-Transfer-Encoding: \n"
"Plural-Forms: \n"

#. module: social_media_calendar
#: model:ir.model.fields,field_description:social_media_calendar.field_social_post__color
msgid "Color"
msgstr ""

#. module: social_media_calendar
#: model:ir.model.fields,field_description:social_media_calendar.field_social_post__date_calendar
msgid "Date Calendar"
msgstr ""

#. module: social_media_calendar
#. odoo-javascript
#: code:addons/social_media_calendar/static/src/js/views/calendar/social_calendar_controller.esm.js:0
#, python-format
msgid "New Post"
msgstr ""

#. module: social_media_calendar
#: model:ir.model,name:social_media_calendar.model_social_post
msgid "Social Post"
msgstr ""

#. module: social_media_calendar
#: model_terms:ir.ui.view,arch_db:social_media_calendar.social_post_view_calendar
msgid "Social Posts"
msgstr ""
4 changes: 4 additions & 0 deletions social_media_calendar/models/__init__.py
Original file line number Diff line number Diff line change
@@ -0,0 +1,4 @@
# Copyright 2025 Binhex <https://www.binhex.cloud>
# License AGPL-3.0 or later (https://www.gnu.org/licenses/agpl).

from . import social_post
Loading
Loading