Author: |
Tecnativa, Odoo Community Association (OCA) |
License: |
AGPL-3 |
Branch: |
14.0-ocabot-merge-pr-708-by-dreispt-bump-nobump |
Repository: |
OCA/social |
Dependencies: |
base,
mail,
and
web |
Languages: |
HTML (409, 1.7%),
JavaScript (519, 2.2%),
PO File (19977, 83.5%),
Python (1731, 7.2%),
Sass (319, 1.3%),
XML (834, 3.5%),
and
reStructuredText (133, 0.6%) |
Other branches: |
10.0,
11.0,
12.0,
13.0,
13.0-ocabot-merge-pr-476-by-simahawk-bump-nobump,
14.0,
14.0-ocabot-merge-pr-708-by-etobella-bump-nobump,
15.0,
8.0,
and
9.0 |
Other repositories: |
2FM/social,
ACCOMODATA-BVBA/social,
AITIC/social,
AMhadhbi/social,
AdriaGForgeFlow/social,
Alfa-90/social,
BADEP/social,
BT-fgarbely/social,
BT-scchmid-test/social,
BeopenMX/social,
Bubbles-IT/social,
CB-Gran-Canaria/social,
Callino/social,
Change2improve/social,
ClearCorp/oca-social,
CompassionCH/social,
Digital5-Odoo/social,
Dobtor-OCA/social,
DucTruongKomit/social,
ERPLibre/social,
ForgeFlow/social,
Gabinete-Digital/social,
Glue-Software-Engineering-AG/social,
Gofekra/social,
Hasnur/social,
ICTSTUDIO/social,
ITISAG-OCA/social,
Ingeos/social,
Jarsa/social,
JazziMc/social,
Judystudy/social,
KasunDA/social,
Kiplangatdan/social,
KomarovAlea/social,
LasLabs/social,
MadsackMediaStore/social,
MathBenTech/social,
MediaJockey/social,
NL66278/social,
NeatNerdPrime/social,
NextERP-Romania/social,
Nooka10/social,
OCA-MUK/social,
ORETEK/social,
OpencloudPro/social,
QubiQ/social,
RLeeOSI/social,
Rad0van/social,
SDIsl/social,
SanteLibre/social,
SequarSrl/social,
SeuMarco/social,
SimoRubi/social,
SolutionSeekers/social,
StefanRijnhart/social,
Studio73/social,
Syci-Consulting/social,
TDu/social,
TRESCLOUD/social,
Tecnativa/social,
Tonow-c2c/social,
Vauxoo/social,
VisiionSolucionesTecnologicas/social,
VitalPet/social,
YogeshMahera-SerpentCS/social,
a0c/social,
aaltinisik/social,
acsone/social,
adhoc-dev/social,
adolfoeliazat/social,
adrienpeiffer/social,
agenterp/social,
agenterpgmbh/social,
agrista/odoo-social,
ajaniszewska-dev/social,
akretion/social,
alexlafalce/social,
anderswallenquist/social,
anhvu-sg/social,
ansinaesmejor/social,
antonyrajserpentcs/social,
anybox/social,
apachesep/social,
apertoso/social,
apetbiz/social,
archetipo/social,
aryajimbaran/social,
auditum-lko/social,
aurestic/social,
avoinsystems/social,
ayush5198/social,
bealdav/social,
bishalgit/social,
bitroniq/social,
brain-tec/social,
brainbeanapps/social,
camptocamp/social,
cedvict/social,
celm1990/social,
chacatico/social,
cocox/social,
coopiteasy/social,
crnd-inc/social,
cunguito/social,
dajuayen/social,
damcar/social,
daramousk/social,
ddico/social,
denislour/social,
dev00007/social,
diagramsoftware/social,
diegobgl/social,
diggy128/social,
dndoanh/social,
dozymoe/social,
dreispt/social,
druidoo-dev/social,
eLBati/social,
eezee-it/social,
emagdalenaC2i/social,
ermannognan/social,
ernestotejeda/social,
eslammohamed13/social,
etobella/social,
eugentaga/social,
exosoftware/oca-social,
extrememicro/social,
fmdl/social,
focusate/oca-social,
gab-net/social,
gfcapalbo/social,
git-service-it-ar/social,
grindtildeath/social,
gurneyalex/social,
haroldtamo/social,
hbrunn/social,
hibou-io/oca-social,
hinfo506/social,
i-vyshnevska/social,
iRichGit/social,
igallart/social,
iledarn/social,
imranissufo/social,
inforconseil/social,
inspiredbusiness/social,
isos/social,
jacky82669513/social,
jerrodmartin/social,
jobiols/oca-social,
kevin070982/social,
kryskool/social,
legalsylvain/social,
leonidasthe300/social,
lesdekock/social,
lincersolucoes/oca-social,
logicasoftadmin/social,
manuelcalerosolis/social,
marcozink/social,
marionumza/social,
markrobinson85/social,
masiunas/social,
mavs2011bs/social,
mechsoftdigital/social,
mgielissen/social,
minhyk/social,
mjadily/social,
modoolar/social,
moltisinc/social,
mozaik-association/social,
mpanarin/social,
myceliandre/social,
nilshamerlinck/social,
niulinlnc/social,
noorealam96/social,
odoobgorg/OCA-social,
odoogap/social,
odoonz/social,
ontruck/social,
open-synergy/social,
osfp-Pakistan/social,
osiell/social,
p-tombez/social,
paulius-sladkevicius/social,
pegonzalezspesol/social,
phucngta/social,
popama/social,
pscloud/social,
publidex/social,
redblow/social,
redcor/social,
rlizana/social,
rossasa/social,
rsullivan2704/social,
rubensben/social,
ruuter/social,
sadeqamin/social,
sanube/social,
savoirfairelinux/social,
scbrianti/social,
semamca35/social,
sergiocorato/social,
serpentcs-dev1/social,
sewisoft/social,
shiram/social,
simahawk/social,
skeller1/social,
solarprocurement/social,
spitronello/social,
sschmid-test-org/social,
steingabelgaard/social,
sunflowerit/social,
sygel-technology/social,
tafaRU/social,
takinobori/oca-social,
takobi-online/social,
tansadio/social,
tbaden/social,
tegin/social,
tfossoul/social,
thinkopensolutions/oca-social,
thinkwelltwd/social,
thomaspot/social,
tirma-sa/social,
tosink/social,
tpalan/social,
tpxxx/social,
tschanzt/social,
ursais/social,
valmarnet/social,
vcloud9ray/social,
versada/social,
wahhid/social,
westlyou/social,
x0rzkov/odoo-social,
xavidj/social,
xcgd/social,
xduran/social,
xpansa/social,
y2gsmith/social,
yusniermatos/social,
and
zestsoftware/social |
<h1 class="title">Email tracking</h1>
<p><a class="reference external" href="https://odoo-community.org/page/development-status"><img alt="Beta" src="https://img.shields.io/badge/maturity-Beta-yellow.png" /></a> <a class="reference external" href="http://www.gnu.org/licenses/agpl-3.0-standalone.html"><img alt="License: AGPL-3" src="https://img.shields.io/badge/licence-AGPL--3-blue.png" /></a> <a class="reference external" href="https://github.com/OCA/social/tree/14.0/mail_tracking"><img alt="OCA/social" src="https://img.shields.io/badge/github-OCA%2Fsocial-lightgray.png?logo=github" /></a> <a class="reference external" href="https://translation.odoo-community.org/projects/social-14-0/social-14-0-mail_tracking"><img alt="Translate me on Weblate" src="https://img.shields.io/badge/weblate-Translate%20me-F47D42.png" /></a> <a class="reference external" href="https://runbot.odoo-community.org/runbot/205/14.0"><img alt="Try me on Runbot" src="https://img.shields.io/badge/runbot-Try%20me-875A7B.png" /></a></p>
<p>This module shows email notification tracking status for any messages in
mail thread (chatter). Each notified partner will have an intuitive icon just
right to his name.</p>
<p><strong>Table of contents</strong></p>
<div class="contents local topic" id="contents">
<ul class="simple">
<li><a class="reference internal" href="#installation" id="id1">Installation</a></li>
<li><a class="reference internal" href="#usage" id="id2">Usage</a></li>
<li><a class="reference internal" href="#known-issues-roadmap" id="id3">Known issues / Roadmap</a></li>
<li><a class="reference internal" href="#bug-tracker" id="id4">Bug Tracker</a></li>
<li><a class="reference internal" href="#credits" id="id5">Credits</a><ul>
<li><a class="reference internal" href="#authors" id="id6">Authors</a></li>
<li><a class="reference internal" href="#contributors" id="id7">Contributors</a></li>
<li><a class="reference internal" href="#other-credits" id="id8">Other credits</a></li>
<li><a class="reference internal" href="#maintainers" id="id9">Maintainers</a></li>
</ul>
</li>
</ul>
</div>
<a name="installation"></a>
<h2><a class="toc-backref" href="#id1">Installation</a></h2>
<p>If you're using a multi-database installation (with or without dbfilter option)
where /web/databse/selector returns a list of more than one database, then
you need to add <code>mail_tracking</code> addon to wide load addons list
(by default, only <code>web</code> addon), setting <code>--load</code> option.
For example, <code>--load=web,mail_tracking</code></p>
<a name="usage"></a>
<h2><a class="toc-backref" href="#id2">Usage</a></h2>
<p>When user sends a message in mail_thread (chatter), for instance in partner
form, then an email tracking is created for each email notification. Then a
status icon will appear just right to name of notified partner.</p>
<p>These are all available status icons:</p>
<p><img alt="unknown" src="https://raw.githubusercontent.com/OCA/social/14.0/mail_tracking/static/src/img/unknown.png" style="width: 10px;" /> <strong>Unknown</strong>: No email tracking info available. Maybe this notified partner has 'Receive Inbox Notifications by Email' == 'Never'</p>
<p><img alt="waiting" src="https://raw.githubusercontent.com/OCA/social/14.0/mail_tracking/static/src/img/waiting.png" style="width: 10px;" /> <strong>Waiting</strong>: Waiting to be sent</p>
<p><img alt="error" src="https://raw.githubusercontent.com/OCA/social/14.0/mail_tracking/static/src/img/error.png" style="width: 10px;" /> <strong>Error</strong>: Error while sending</p>
<p><img alt="sent" src="https://raw.githubusercontent.com/OCA/social/14.0/mail_tracking/static/src/img/sent.png" style="width: 10px;" /> <strong>Sent</strong>: Sent to SMTP server configured</p>
<p><img alt="delivered" src="https://raw.githubusercontent.com/OCA/social/14.0/mail_tracking/static/src/img/delivered.png" style="width: 15px;" /> <strong>Delivered</strong>: Delivered to final MX server</p>
<p><img alt="opened" src="https://raw.githubusercontent.com/OCA/social/14.0/mail_tracking/static/src/img/opened.png" style="width: 15px;" /> <strong>Opened</strong>: Opened by partner</p>
<p><img alt="cc" src="https://raw.githubusercontent.com/OCA/social/14.0/mail_tracking/static/src/img/cc.png" style="width: 10px;" /> <strong>Cc</strong>: It's a Carbon-Copy recipient. Can't know the status so is 'Unknown'</p>
<p><img alt="noemail" src="https://raw.githubusercontent.com/OCA/social/14.0/mail_tracking/static/src/img/no_email.png" style="width: 10px;" /> <strong>No Email</strong>: The partner doesn't have a defined email</p>
<p><img alt="anonuser" src="https://raw.githubusercontent.com/OCA/social/14.0/mail_tracking/static/src/img/anon_user.png" style="width: 10px;" /> <strong>No Partner</strong>: The recipient doesn't have a defined partner</p>
<p>If you want to see all tracking emails and events you can go to</p>
<ul class="simple">
<li>Settings > Technical > Email > Tracking emails</li>
<li>Settings > Technical > Email > Tracking events</li>
</ul>
<p>When the message generates an 'error' status, it will apear on discuss 'Failed'
channel. Any view with chatter can show the failed messages
too.</p>
<ul>
<li><p class="first">Discuss</p>
<img alt="https://raw.githubusercontent.com/OCA/social/14.0/mail_tracking/static/img/failed_message_discuss.png" src="https://raw.githubusercontent.com/OCA/social/14.0/mail_tracking/static/img/failed_message_discuss.png" />
</li>
<li><p class="first">Chatter</p>
<img alt="https://raw.githubusercontent.com/OCA/social/14.0/mail_tracking/static/img/failed_message_widget.png" src="https://raw.githubusercontent.com/OCA/social/14.0/mail_tracking/static/img/failed_message_widget.png" />
</li>
</ul>
<p>You can use "Failed sent messages" filter present in all views to show records
with messages in failed status and that needs an user action.</p>
<ul>
<li><p class="first">Filter</p>
<img alt="https://raw.githubusercontent.com/OCA/social/14.0/mail_tracking/static/img/failed_message_filter.png" src="https://raw.githubusercontent.com/OCA/social/14.0/mail_tracking/static/img/failed_message_filter.png" />
</li>
</ul>
<a name="known-issues-roadmap"></a>
<h2><a class="toc-backref" href="#id3">Known issues / Roadmap</a></h2>
<ul class="simple">
<li>Add pivot for tracking events and mail trackings</li>
</ul>
<a name="bug-tracker"></a>
<h2><a class="toc-backref" href="#id4">Bug Tracker</a></h2>
<p>Bugs are tracked on <a class="reference external" href="https://github.com/OCA/social/issues">GitHub Issues</a>.
In case of trouble, please check there if your issue has already been reported.
If you spotted it first, help us smashing it by providing a detailed and welcomed
<a class="reference external" href="https://github.com/OCA/social/issues/new?body=module:%20mail_tracking%0Aversion:%2014.0%0A%0A**Steps%20to%20reproduce**%0A-%20...%0A%0A**Current%20behavior**%0A%0A**Expected%20behavior**">feedback</a>.</p>
<p>Do not contact contributors directly about support or help with technical issues.</p>
<a name="credits"></a>
<h2><a class="toc-backref" href="#id5">Credits</a></h2>
<a name="authors"></a>
<h3><a class="toc-backref" href="#id6">Authors</a></h3>
<ul class="simple">
<li>Tecnativa</li>
</ul>
<a name="contributors"></a>
<h3><a class="toc-backref" href="#id7">Contributors</a></h3>
<ul class="simple">
<li><a class="reference external" href="https://www.tecnativa.com">Tecnativa</a>:<ul>
<li>Pedro M. Baeza</li>
<li>Antonio Espinosa</li>
<li>David Vidal</li>
<li>Ernesto Tejeda</li>
<li>Rafael Blasco</li>
<li>Alexandre Díaz</li>
</ul>
</li>
</ul>
<a name="other-credits"></a>
<h3 class="with-subtitle"><a class="toc-backref" href="#id8">Other credits</a></h3>
<h3 class="section-subtitle" id="images"><span class="section-subtitle">Images</span></h3>
<ul class="simple">
<li>Odoo Community Association: <a class="reference external" href="https://github.com/OCA/maintainer-tools/blob/master/template/module/static/description/icon.svg">Icon</a>.</li>
<li>Thanks to <a class="reference external" href="https://openclipart.org/user-detail/LlubNek">LlubNek</a> and <a class="reference external" href="https://openclipart.org">Openclipart</a> for <a class="reference external" href="https://openclipart.org/detail/19342/open-envelope">the icon</a>.</li>
</ul>
<a name="maintainers"></a>
<h3><a class="toc-backref" href="#id9">Maintainers</a></h3>
<p>This module is maintained by the OCA.</p>
<a class="reference external image-reference" href="https://odoo-community.org"><img alt="Odoo Community Association" src="https://odoo-community.org/logo.png" /></a>
<p>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.</p>
<p>This module is part of the <a class="reference external" href="https://github.com/OCA/social/tree/14.0/mail_tracking">OCA/social</a> project on GitHub.</p>
<p>You are welcome to contribute. To learn how please visit <a class="reference external" href="https://odoo-community.org/page/Contribute">https://odoo-community.org/page/Contribute</a>.</p>
Dependency Graph