仁杰 | Odoo Connects Everything

如何提交应用和主题至Odoo Apps市场

首先得有一个Odoo官网帐号，注册
https://www.odoo.com/web/signup

登录并提交您的Git仓库地址
https://apps.odoo.com/apps/upload
如：

git@github.com:surenjie/odoo.git#8.0
https://github.com/surenjie/odoo.git#9.0

1 2	git@github.com:surenjie/odoo.git#8.0 https://github.com/surenjie/odoo.git#9.0

注意：
仓库根目录每一个应用或主题都分别对应一个子目录（多个应用和主题一起发布机制）
仓库地址末尾添加#分支名称来指定版本分支（#在URL里称为锚）
分支名称用于匹配模块的系列版本号（可多个不同版本用于对应的系统版本）

仓库管理
https://apps.odoo.com/apps/dashboard/repos
一个应用多个分支版本需要分别多次提交
每个新提交仓库默认Draft状态，需要点击Scan操作变成Active状态后
就可以在My Apps中看到自己新发布的应用了
后续应用更新先提交对应分支版本
然后My Repos中执行Scan操作即可同步市场

我想出售自己的模块？
可以在官方的的应用程序平台上出售自己的模块。只要在模块描述文件__openerp__.py里简单的增加价格和货币项{‘price’: 49.99, ‘currency’: ‘EUR’}就可以开始销售您的模块。目前支持的货币为欧元和美元。官方要求在应用程序平台上出售的模块都有一个适当的描述，完整的功能截图和整体美观大方的展示页。关于如何实现这一目标，请参考以下部分的更多信息。官方保留三无模块的下架权利

我的模块要卖多少钱？
不要担心您工作应得的价值！如果有人需要你模块的功能，他们将为它支付。在任何情况下，这会使他们节约所开发的时间，所以你不应该低估你的工作。官方认为100欧元是一个很好的起点：）

我的模块如何拥有一个友好的图标和描述？
从8.0版本开始，模块图标可放置于模块文件夹/static/description/icon.png
相关截图在模块描述文件中定义，可多个

'images': [
    'static/description/main_screenshot.png'
]

'images': [

'static/description/main_screenshot.png'

]

富文本HTML描述则来自于模块文件夹/static/description/index.html
建议参照这个官方模板
https://github.com/odoo/odoo/blob/master/addons/crm/static/description/index.html

我的模块文档如何展示？
模块文件夹/doc/index.rst文件会被自动加载为文档。它必须是一个有效的RST文件

我的模块收入如何得到？
您在官方平台上模块收入的70%将会给你。只要发给他们每售出模块和价格编号的单据。你可以在你的销售仪表盘中找到这些信息（https://apps.odoo.com/apps/dashboard/sales）。考虑到处理这些单据需要时间，请理解官方只处理累计总额不少于400欧元的单据

我的代码仓库是私有的怎么办？
要在官方平台上发布您的模块，他们需要被允许从您的私有库中读取。如果您在GitHub上，只要简单授权online-odoo用户访问即可。如果不是，您将需要授权官方的public SSH key来代替。最后不要忘记使用SSH地址来注册您的仓库好让他们确定使用SSH协议

我还有其他问题？
请直接联系官方邮箱apps@odoo.com，据说他们将会竭诚为您服务。。。

odoo开发支持国际化语言的第三方应用

英语开发并安装好应用的单语言版本
普通视图元素的string、help、sum、confirm、placeholder属性文本自动导出
QWeb模版（包括服务端和客户端两个部分），如果没有用t-translation=”off”关闭翻译，
则title、alt、label、placeholder属性文本也会自动导出
关于模型字段(Model Field)，如果模型没有标注_translate = False：则string和help属性默认可导出；selection类型字段文本也可导出；translate属性设置为True，则所有存在值(values)都会导出
_constraints和_sql_constraints约束中的help、error信息会导出
其它代码里显式调用国际化字符串获取接口的参数值一同导出

#Python
title = openerp._("Bank Accounts")

//JavaScript
title = openerp.web._t("Bank Accounts")

#Python

title = openerp._("Bank Accounts")

//JavaScript

title = openerp.web._t("Bank Accounts")

管理员设置
翻译(Translations)=》导入/导出(Import / Export)=》导出翻译(Export Translations)
语言(Language)选择新语言翻译模版(New Language Empty translation template)
文件格式(File Format)选择PO File
导出应用(Apps To Export)里选择您的模块
导出(Export)=>下载《模块名.pot》文件

模块新增i18n目录
将上一步导出的文件移进去作为基准翻译模版
以此模版为基础简单的另存为其它语言文件如：zh_CN.po
或者使用PO editor等编辑软件所译即所得自动生成
还可以当前目录直接运行msginit命令默认生成操作系统对应的语言版本文件

[srj@x1c i18n]$ msginit 
msginit: 输出文件 zh_CN.po 已经存在。
         请通过 --locale 选项指定语系或
         --output-file 选项指定输出的 .po 文件。

[srj@x1c i18n]$ msginit

msginit: 输出文件 zh_CN.po 已经存在。

请通过 --locale 选项指定语系或

--output-file 选项指定输出的 .po 文件。

与直接模版另存为比较多了以下三项区别：

"Last-Translator: renjie <i@renjie.me>\n"
"Language-Team: Chinese (simplified)\n"
"Language: zh_CN\n"

"Last-Translator: renjie <i@renjie.me>\n"

"Language-Team: Chinese (simplified)\n"

"Language: zh_CN\n"

根据语言文件内的各项原文本msgid部分翻译成对应的msgstr值
加载翻译分别选择各种语言并覆盖已存在的术语（odoo9更新模块也可达到部分效果）
选择不同的用户语言即可整体确认翻译质量

应用发布
odoo9和odoo8的翻译文件不太兼容，主要是因为各自对msgid的引用方式不同
需要分别针对不同版本的系统制作翻译文件并发布到对应分支上

浏览器每次访问odoo自动向官方服务器发送公司database.uuid信息

Odoo是经典的Web富客户端应用，每次启动都需要预加载很多资源
但是突然有一个外域请求让人很奇怪：

Remote Address:195.154.55.54:443
Request URL:https://services.openerp.com/openerp-enterprise/ab/css/2ad90276-9cfa-11e5-9d21-5ce0c51da5ec.css
Request Method:GET
Status Code:301 Moved Permanently
===============》
Content-Length:184
Content-Type:text/html
Location:https://www.odoo.com/openerp-enterprise/ab/css/2ad90276-9cfa-11e5-9d21-5ce0c51da5ec.css
Server:nginx/1.6.3

Remote Address:195.154.55.54:443
Request URL:https://www.odoo.com/openerp-enterprise/ab/css/2ad90276-9cfa-11e5-9d21-5ce0c51da5ec.css
Request Method:GET
Status Code:200 OK
===============》
Connection:keep-alive
Content-Length:0
Content-Type:text/css
Server:nginx/1.6.3

Remote Address:195.154.55.54:443

Request URL:https://services.openerp.com/openerp-enterprise/ab/css/2ad90276-9cfa-11e5-9d21-5ce0c51da5ec.css

Request Method:GET

Status Code:301 Moved Permanently

===============》

Content-Length:184

Content-Type:text/html

Location:https://www.odoo.com/openerp-enterprise/ab/css/2ad90276-9cfa-11e5-9d21-5ce0c51da5ec.css

Server:nginx/1.6.3

Remote Address:195.154.55.54:443

Request URL:https://www.odoo.com/openerp-enterprise/ab/css/2ad90276-9cfa-11e5-9d21-5ce0c51da5ec.css

Request Method:GET

Status Code:200 OK

===============》

Connection:keep-alive

Content-Length:0

Content-Type:text/css

Server:nginx/1.6.3

初步分析是一个html link标签发出的get css请求，然后通过301跳转了一次还是空白返回。虽诡异但合规，所以浏览器也没有任何报错
关键就在于这个请求的文件名：2ad90276-9cfa-11e5-9d21-5ce0c51da5ec.css
前缀其实就是系统参数里的database.uuid信息值
这就说明odoo官方其实是可以根据这个估算出每个实施项目的用户情况统计

但对于访问用户来说，虽然是异步请求，但只要没意义多一个都嫌多，特别是内网用户
经过阅读源码发现统计请求来自mail模块(Discussions, Mailing Lists, News)里的announcement.js，其几十行javascript代码随便注释下就可以搞定

刚巧最近在研究应用开发，知道前后端的模版都可以通过继承的方式来进行间接修改
那样最大的好处是官方的源码可以随时同步更新而不用担心直接修改带来的合并冲突
从前端架构的角度来说，模版的继承特性比模块类的继承特性难度大多了，查了下官方文档果然有记载模块类重载的方法

最终根据odoo8和odoo9的异同点特性不断精炼，得到如下兼容代码：

openerp.none_odoo = function(instance, local) {
    instance.web.WebClient.include({
        show_annoucement_bar: function() {
            // 8.0
            return;
        },
        show_announcement_bar: function() {
            // 9.0
            return;
        }
    });
}

openerp.none_odoo = function(instance, local) {

instance.web.WebClient.include({

show_annoucement_bar: function() {

// 8.0

return;

show_announcement_bar: function() {

// 9.0

return;

}

});

}

虽然简洁，但不能直接拿来即用，但懂应用开发的朋友绝对一看便知：）

nginx统一多个server location favicon.ico

icon文件存放位置
/var/www/favicon/favicon.ico

/etc/nginx/conf.d/favicon.cnf

location = /favicon.ico {
    root    /var/www/favicon/;
}

location = /favicon.ico {

root /var/www/favicon/;

}

或者忽略错误与访问日志

location = /favicon.ico {
    log_not_found off;
    access_log off;
}

location = /favicon.ico {

log_not_found off;

access_log off;

}

/etc/nginx/conf.d/domain.conf等相关server段里面include统一管理

server {
    include /etc/nginx/conf.d/favicon.cnf;
}

server {

include /etc/nginx/conf.d/favicon.cnf;

}

半年多没回来窗外已成马蜂家园

马蜂窝

拉开窗帘着实吓一跳，马上微信金牌物业，立马派人上门搞定，师傅说这事经常有，可见生态要多好

十年少爬的白云山近期要一次性全补上

白云山

可惜没有庐山那种终身卡，要不然更有收藏欲望。。。

浏览器书签功能脚本导入文件模版

今天用bookmark script快速实现了一个小功能想分享给朋友
为了将使用过程包装成足够简单易用，我想到了用书签文件交流这种方式
本以为用浏览器导出对应的书签即可，没想到大部分的浏览器只有全部导出功能
于是非常必要有一个最小结构的模版方便随时填充随时交换

<!DOCTYPE NETSCAPE-Bookmark-file-1> 
<META HTTP-EQUIV="Content-Type" CONTENT="text/html; charset=UTF-8"> 
<TITLE>Bookmarks</TITLE> 
<H1>Bookmarks</H1> 
<DL>
  <DT><H3>Script</H3></DT> 
  <DL> 
    <DT><A HREF="javascript:void(alert('test'))">test</A></DT>
  </DL> 
</DL>

<!DOCTYPE NETSCAPE-Bookmark-file-1>

<TITLE>Bookmarks</TITLE>

<H1>Bookmarks</H1>

<DL>

<DT><H3>Script</H3></DT>

<DL>

</DL>

odoo.py auto-reload dev自动重启服务ENOSPC系统错误解决

Odoo8：
正常环境下直接–auto-reload参数运行缺库错误

ImportError: No module named pyinotify

1	ImportError: No module named pyinotify

pyinotify是一个Python模块，用来监测文件系统的变化
pyinotify依赖于Linux内核的inotify功能，是一个事件驱动的通知器，其通知接口通过三个系统调用从内核空间到用户空间
pyinotify结合这些系统调用，并提供一个顶级的抽象和一个通用的方式来处理这些功能

安装
pip install pyinotify

运行时错误：

pyinotify.py", line 1943, in add_watch
    self._inotify_wrapper.str_errno()))
UnicodeDecodeError: 'ascii' codec can't decode byte 0xe8 in position 6: ordinal not in range(128)

pyinotify.py", line 1943, in add_watch

self._inotify_wrapper.str_errno()))

UnicodeDecodeError: 'ascii' codec can't decode byte 0xe8 in position 6: ordinal not in range(128)

Odoo9：
正常环境下直接–dev参数运行日志警告

WARNING ? openerp.service.server: 'watchdog' module not installed. Code autoreload feature is disabled

1	WARNING ? openerp.service.server: 'watchdog' module not installed. Code autoreload feature is disabled

Watchdog是一个跨平台的Python库和shell工具，可以监视文件系统事件。超级好用，并且容易上手

安装
pip install watchdog

运行时错误：

watchdog/observers/inotify_c.py", line 402, in _raise_error
    raise OSError("inotify watch limit reached")
OSError: inotify watch limit reached

watchdog/observers/inotify_c.py", line 402, in _raise_error

raise OSError("inotify watch limit reached")

OSError: inotify watch limit reached

Node：
想起来当初刚玩node时也时常会遇到这个错误
不过大多直接sudo运行就可解决，简单理解权限问题也没有深究
但是odoo不能这么搞，源码限制：

Running as user 'root' is a security risk, aborting.

1	Running as user 'root' is a security risk, aborting.

还好从odoo9的报错信息里显而易见问题出自底层inotify对一般用户的限制
简单学习了下，得知其有个max_user_watches的内核参数限制普通用户一次最多关联监控个数。一般默认值8192，对于odoo这种大工程或稍大一点的node项目来说明显是不够用的

先通过如下方式验证：

[srj@x1c /]$ cat /proc/sys/fs/inotify/max_user_watches
8192

1 2	[srj@x1c /]$ cat /proc/sys/fs/inotify/max_user_watches 8192

然后通过su切换root身份动态更新配置值放大64倍

[srj@x1c /]$ su -c 'echo 524288 > /proc/sys/fs/inotify/max_user_watches'

1	[srj@x1c /]$ su -c 'echo 524288 > /proc/sys/fs/inotify/max_user_watches'

接着用不同版本的启动参数运行即可看到AutoReload watcher running成功了

INFO ? openerp.service.server: Watching addons folder /home/srj/.local/share/Odoo/addons/8.0
INFO ? openerp.service.server: AutoReload watcher running

1 2	INFO ? openerp.service.server: Watching addons folder /home/srj/.local/share/Odoo/addons/8.0 INFO ? openerp.service.server: AutoReload watcher running

最后还需要将动态修改的参数通过静态配置方式固化下来，否则每次重启还需要重复修改
Centos7下我不建议直接修改/etc/sysctl.conf文件配置，而是通过sysctl.d目录新建独立配置

[root@x1c sysctl.d]# pwd
/etc/sysctl.d
[root@x1c sysctl.d]# echo fs.inotify.max_user_watches = 524288 > 91-inotify.conf 
[root@x1c sysctl.d]# cat 91-inotify.conf 
fs.inotify.max_user_watches = 524288

[root@x1c sysctl.d]# pwd

/etc/sysctl.d

[root@x1c sysctl.d]# echo fs.inotify.max_user_watches = 524288 > 91-inotify.conf

[root@x1c sysctl.d]# cat 91-inotify.conf

fs.inotify.max_user_watches = 524288

然后重新启动或者使用

[root@x1c sysctl.d]# sysctl --system
* Applying /etc/sysctl.d/91-inotify.conf ...
fs.inotify.max_user_watches = 524288
* Applying /etc/sysctl.conf ...

[root@x1c sysctl.d]# sysctl --system

* Applying /etc/sysctl.d/91-inotify.conf ...

fs.inotify.max_user_watches = 524288

* Applying /etc/sysctl.conf ...

sysctl命令system参数立刻生效

海南万宁新中农场

新中农场

每个人心中都有一个自己的农场梦
国庆外面熙熙攘攘，但这里可以找到内心久违的平静

Linux centos yum install odoo rpm postinstall scriptlet

众所周知，odoo官方提供了非常方便的yum安装源用于一键安装
只需先根据版本配置源

odoo8

yum-config-manager --add-repo=https://nightly.odoo.com/8.0/nightly/rpm/odoo.repo

1	yum-config-manager --add-repo=https://nightly.odoo.com/8.0/nightly/rpm/odoo.repo

odoo9

yum-config-manager --add-repo=https://nightly.odoo.com/9.0/nightly/rpm/odoo.repo

1	yum-config-manager --add-repo=https://nightly.odoo.com/9.0/nightly/rpm/odoo.repo

之后即可一键自动解决依赖安装

yum install -y odoo

1	yum install -y odoo

相信源码安装过的同学都一定很好奇
这么繁琐复杂的细节居然可以全部包装到一个rpm包里透明掉了
还有那么多依赖库，怎么可能yum里全部都有
带着这种疑问认真研究了下
才知道rpm包内除了相应的程序，还可能有pre和post install两个shell脚本
分别对应安装前和安装后执行
以下为8.0版本latest rpm包为例，其中文注释为本人补充方便整体理解

rpm -qp --scripts odoo_8.0.latest.noarch.rpm
postinstall scriptlet (using /bin/sh):
#!/bin/sh
#错误立即退出
set -e
#配置目录
ODOO_CONFIGURATION_DIR=/etc/odoo
#配置文件
ODOO_CONFIGURATION_FILE=$ODOO_CONFIGURATION_DIR/openerp-server.conf
#数据目录
ODOO_DATA_DIR=/var/lib/odoo
ODOO_GROUP="odoo"
#日志目录
ODOO_LOG_DIR=/var/log/odoo
ODOO_USER="odoo"
#创建系统用户及用户组
if ! getent passwd | grep -q "^odoo:"; then
    groupadd $ODOO_GROUP
    adduser --system --no-create-home $ODOO_USER -g $ODOO_GROUP
fi
# Register "$ODOO_USER" as a postgres user with "Create DB" role attribute
su - postgres -c "createuser -d -R -S $ODOO_USER" 2> /dev/null || true
# Configuration file
mkdir -p $ODOO_CONFIGURATION_DIR
# can't copy debian config-file as addons_path is not the same
echo "[options]
; This is the password that allows database operations:
; admin_passwd = admin
db_host = False
db_port = False
db_user = $ODOO_USER
db_password = False
addons_path = /usr/lib/python2.7/site-packages/openerp/addons
" > $ODOO_CONFIGURATION_FILE
#配置文件权限设置
chown $ODOO_USER:$ODOO_GROUP $ODOO_CONFIGURATION_FILE
chmod 0640 $ODOO_CONFIGURATION_FILE
# Log
mkdir -p $ODOO_LOG_DIR
chown $ODOO_USER:$ODOO_GROUP $ODOO_LOG_DIR
chmod 0750 $ODOO_LOG_DIR
# Data dir
mkdir -p $ODOO_DATA_DIR
chown $ODOO_USER:$ODOO_GROUP $ODOO_DATA_DIR
#系统服务
INIT_FILE=/lib/systemd/system/odoo.service
touch $INIT_FILE
chmod 0700 $INIT_FILE
cat << 'EOF' > $INIT_FILE
[Unit]
Description=Odoo Open Source ERP and CRM
After=network.target

[Service]
Type=simple
User=odoo
Group=odoo
ExecStart=/usr/bin/odoo.py --config=/etc/odoo/openerp-server.conf

[Install]
WantedBy=multi-user.target
EOF
#YUM中没有的Python依赖库部分
easy_install pyPdf vatnumber pydot psycogreen

rpm -qp --scripts odoo_8.0.latest.noarch.rpm

postinstall scriptlet (using /bin/sh):

#!/bin/sh

#错误立即退出

set -e

#配置目录

ODOO_CONFIGURATION_DIR=/etc/odoo

#配置文件

ODOO_CONFIGURATION_FILE=$ODOO_CONFIGURATION_DIR/openerp-server.conf

#数据目录

ODOO_DATA_DIR=/var/lib/odoo

ODOO_GROUP="odoo"

#日志目录

ODOO_LOG_DIR=/var/log/odoo

ODOO_USER="odoo"

#创建系统用户及用户组

if ! getent passwd | grep -q "^odoo:"; then

groupadd $ODOO_GROUP

adduser --system --no-create-home $ODOO_USER -g $ODOO_GROUP

# Register "$ODOO_USER" as a postgres user with "Create DB" role attribute

su - postgres -c "createuser -d -R -S $ODOO_USER" 2> /dev/null || true

# Configuration file

mkdir -p $ODOO_CONFIGURATION_DIR

# can't copy debian config-file as addons_path is not the same

echo "[options]

; This is the password that allows database operations:

; admin_passwd = admin

db_host = False

db_port = False

db_user = $ODOO_USER

db_password = False

addons_path = /usr/lib/python2.7/site-packages/openerp/addons

" > $ODOO_CONFIGURATION_FILE

#配置文件权限设置

chown $ODOO_USER:$ODOO_GROUP $ODOO_CONFIGURATION_FILE

chmod 0640 $ODOO_CONFIGURATION_FILE

# Log

mkdir -p $ODOO_LOG_DIR

chown $ODOO_USER:$ODOO_GROUP $ODOO_LOG_DIR

chmod 0750 $ODOO_LOG_DIR

# Data dir

mkdir -p $ODOO_DATA_DIR

chown $ODOO_USER:$ODOO_GROUP $ODOO_DATA_DIR

#系统服务

INIT_FILE=/lib/systemd/system/odoo.service

touch $INIT_FILE

chmod 0700 $INIT_FILE

cat << 'EOF' > $INIT_FILE

[Unit]

Description=Odoo Open Source ERP and CRM

After=network.target

[Service]

Type=simple

User=odoo

Group=odoo

ExecStart=/usr/bin/odoo.py --config=/etc/odoo/openerp-server.conf

[Install]

WantedBy=multi-user.target

EOF

#YUM中没有的Python依赖库部分

easy_install pyPdf vatnumber pydot psycogreen

可见诸多内幕与细节全都在这段脚本里完美体现了
知己知彼，剖析清楚每一行代码后，对基于源代码的个性化定制安装部署又有了新的认识