标签：registry func 转换 bottom 之间 文档 nav views release
管理静态资产
还有其他一些用于特定应用程序的资产包:point_of_sale.assets, survey.survey_assets, mass_mailing.layout, 和 website_slides.slide_embed_assets.
Odoo通过AssetsBundle类管理它的静态资产，它位于/odoo/addons/base/models/assetsbundle.py。资产包不仅组合了多个文件;它还包含了更多的特性。这里是它提供的功能列表:
自定义资产
正如我们所看到的，Odoo对于不同的代码库有不同的资产。为了得到正确的结果，您需要选择正确的资产包，将定制的JavaScript和CSS文件放在其中。例如，如果你正在设计一个网站，你需要把你的文件放在web.assets_frontend。在下一个章节中，您将看到如何在现有的资产包中包含定制的CSS/JavaScript。尽管这种情况很少见，但有时您需要创建一个全新的资产包。您可以创建自己的资产包，正如我们将在下一节中描述的那样。
怎么做呢?
按照以下步骤创建一个自定义资产包:
1. 创建QWeb模板，并添加您的JavaScript, CSS，或SCSS文件，如下:
<template id="my_custom_assets" name="My Custom Assets">
<link rel="stylesheet" type="text/scss" href="/my_module/static/src/scss/my_scss.scss"/>
<link rel="stylesheet" type="text/css" href="/my_module/static/src/scss/my_css.css"/>
<script type="text/JavaScript" src="/my_module/static/src/js/widgets/my_JavaScript.js"/>
</template>
2. 在您想要加载此包的QWeb模板中使用t-call-assets，如下所示:
<template id="some_page">
...
<head>
<t t-call-assets="my_module.my_custom_assets" tjs="false"/>
<t t-call-assets="my_module.my_custom_assets" tcss="false"/>
</head>
...
它是如何工作的…
在步骤1中，我们使用外部ID my_custom_assets创建了新的QWeb模板。在这个模板中，您需要列出所有的CSS、SCSS和JavaScript文件。首先，Odoo将编译SCSS文件到CSS，然后，Odoo将结合所有的CSS和JavaScript文件到一个单独的CSS和JavaScript文件。声明资产之后，需要将它们加载到QWeb模板(web页面)中。
在步骤2中，我们已经在模板中加载了CSS和JavaScript资产。t-css和t-js属性仅用于加载样式表或脚本。
在大多数网站开发中，您需要在现有的资产包中添加JavaScript和CSS文件。添加一个新的资产包是非常罕见的。只有当你想开发没有Odoo CMS功能的页面/应用程序时才需要。在下一个章节中，您将了解如何在现有的资产包中添加自定义CSS/JavaScript。
有更多的…
如果您正在使用Odoo中的资产，以下是您需要知道的一些事情
在Odoo中调试JavaScript非常困难，因为AssetBundle会将多个JavaScript文件合并到一个文件中，并且还会缩小它们。
调试JavaScript可能是非常困难的Odoo，因为AssetBundle合并多个JavaScript文件到一个单一的，也缩小了他们。通过使用资产启用developer模式，您可以跳过资产绑定，并且页面将分别加载静态资产，以便您可以轻松地进行调试。通过启用带资产的developer模式，您可以跳过资产绑定，并且页面将分别加载静态资产，以便您可以轻松地进行调试。
合并后的资产只生成一次，并存储在ir.attachment模型中。之后，它将从附件中提供。如果您想重新生成资产，您可以从调试选项中进行，如下面的截图所示:
合并后的资产只生成一次并存储在ir中。附件的模型。之后，它将从附件中提供。如果您想重新生成资产，您可以从调试选项中进行，如下面的截图所示:
如您所知，Odoo将只生成一次资产。这种行为在开发过程中可能会令人头疼，因为它需要频繁地重新启动服务器。要克服这个问题，可以在命令行中使用dev=xml，它将直接加载资产，因此不需要重新启动服务器。
扩展CSS和JavaScript的网站
在这个章节中，我们将介绍如何添加自定义样式表和JavaScript到网站。
准备
我们将使用第4章中的my_library模块，创建Odoo附加模块。我们将添加CSS, SCSS和JavaScript文件，这些文件将修改网站。由于我们正在修改网站，我们将需要添加网站的依赖性。像这样修改清单:
...
‘depends‘: [‘base‘, ‘website‘],
...
怎么做呢?
覆盖主网站模板，注入你的代码，如下:
1. 添加一个名为views/templates.xml的文件，并添加一个空视图覆盖，如下所示(不要忘记在__manifest__ .py中列出该文件):
<odoo>
<template id="assets_frontend" inherit_id="web.assets_frontend">
<xpath expr="." position="inside">
<! -- points 2 & 3 go here /-->
</xpath>
</template>
</odoo>
2. 添加CSS和SCSS文件的引用，如下:
<link href="/my_library/static/src/css/my_library.css" rel="stylesheet" type="text/css"/>
<link href="/my_library/static/src/scss/my_library.scss" rel="stylesheet" type="text/scss"/>
3.添加一个引用到你的JavaScript文件，如下:
<script src="/my_library/static/src/js/my_library.js" type="text/JavaScript" />
4. 添加一些CSS代码到static/src/ CSS /my_library.css,如下:
body main {
background: #b9ced8;
}
5. 向static/src/ SCSS my_library.scss添加一些SCSS代码。scss,如下所示:
$my-bg-color: #1C2529;
$my-text-color: #D3F4FF;
nav.navbar {
background-color: $my-bg-color !important;
.navbar-nav .nav-link span{
color: darken($my-text-color, 15);
font-weight: 600;
}
}
footer.o_footer {
background-color: $my-bg-color !important;
color: $my-text-color;
}
6. 添加一些JavaScript代码到static/src/js/my_library.js如下:
odoo.define(‘my_library‘, function (require) {
var core = require(‘web.core‘);
alert(core._t(‘Hello world‘));
return {
// if you created functionality to export, add it here
}
});
更新你的模块后，你应该看到Odoo网站有自定义的颜色在菜单，正文，和页脚，和一个有点恼人的Hello world弹出在每个页面加载，如下截图所示:
它是如何工作的…
在Odoo的CMS基础上有一个名为QWeb的XML模板引擎，我们将在下一篇文章中详细讨论它。资产包只是用模板创建的。在步骤1、2和3中，我们通过扩展web.assets_frontend列出了样式表和JavaScript文件。我们选择web.assets_frontend是因为我们想更新网站。这些资产被载入每个网站页面。
在第4步中，我们添加了CSS，用于设置网站的主体背景颜色。
对于CSS/SCSS文件，有时候，顺序很重要。因此，如果您需要覆盖在另一个附加组件中定义的样式，您必须注意您的文件是在您想要修改的原始文件之后加载的。
这可以通过调整视图的优先级字段或直接继承加载项的视图来实现，该视图将引用注入CSS文件。有关详细信息，请参阅第10章后端视图中的更改现有视图-视图继承配方。
在步骤5中，我们添加了基本的SCSS。Odoo内置了对SCSS预处理器的支持。Odoo将自动编译SCSS文件到CSS。在我们的示例中，我们使用了带有一些变量的基本SCSS和函数darken来将$my-text-color调暗15%。SCSS预处理器有大量的其他特性;如果你想了解更多关于SCSS的信息，请参考‘http://sass- lang.com/。
Odoo 12之前的版本使用的是Bootstrap 3，它使用的较少(http://lesscss.org)预处理器。Odoo版本12使用了最新的Bootstrap版本，它是Bootstrap 4 (https://getbootstrap. com/ )。它使用SCSS。因此，如果您使用的是较老的Odoo版本，则需要编写更少的代码而不是SCSS。
在第6步中，我们添加了基本的JavaScript，它只在页面加载时显示警告消息。为了避免JavaScript的排序问题，Odoo使用了一种非常类似RequireJS的机制(http://requirejs.org)。在我们的JavaScript文件中，我们调用了odoo.define()，它需要两个参数，一个是要定义的名称空间，另一个是包含实际实现的函数。如果您导出了功能的许多逻辑上不同的部分，那么在不同的函数中定义它们，并在前面加上您的附加组件的名称，并用点分隔，以避免将来的命名冲突。这就是web模块所做的，它定义了web.core和web.data等。
对于第二个参数，定义函数只接收一个参数require，您可以使用该函数获取对其他模块或核心中定义的JavaScript名称空间的引用。使用这个与Odoo的所有交互，永远不要依赖于全局Odoo对象。
然后，您自己的函数可以返回一个对象，该对象指向您希望为其他附加组件提供的引用，或者如果没有这样的引用，则不返回任何引用。如果你已经从你的函数返回了一些引用，你可以在另一个函数中使用它们，如下面的例子所示:
odoo.define(‘my_module‘, function (require) {
var test = {
key1: ‘value1‘,
key2: ‘value2‘
};
var square = function(number) {
return 2*2;
};
return {
test: test,
square: square
}
});
// In another file
odoo.define(‘another_module‘, function (require) {
var my_module = require(‘my_module‘);
console.log(my_module.test.key1);
console.log(‘square of 5 is‘, my_module.square(5));
});
介绍了Odoo 9.0的要求机制。在旧版本中，处理JavaScript的外接程序需要在openerp命名空间中定义与外接程序同名的函数。此函数接收到当前加载实例的引用作为参数，从该参数访问API函数。因此，为了升级现有代码，将其更改为odoo.define子句，并通过require导入必要的对象。
创建或修改模板- QWeb
我们将为在第5章“应用模型”中开发的my_library插件添加网站功能。我们感兴趣的是允许用户浏览图书馆，如果他们以适当的权限登录，使他们能够从网站界面编辑图书详细信息。
怎么做呢?
我们需要定义以下几个控制器和视图:
1. 在views/templates.xml中添加一个最小模板，如下所示:
<?xml version="1.0" encoding="utf-8"?>
<odoo>
<template id="books">
<t t-call="website.layout">
<!-- Add page elements here -->
</t>
</template>
</odoo>
2. 在website.layout中，使用oe_structure类添加droppable元素，如下所示:
<div class="oe_structure">
<section class="pt32 pb32 bg-secondary oe_custom_bg">
<div class="container text-center">
<h1> Editable text and supports drag and drop.</h1>
</div>
</section>
</div>
3.将代码块附加到网站中。显示图书信息的版面如下:
<div class="container">
<t t-foreach="books" t-as="book">
<div t-attf-class="card mt-3 #{‘bg-info‘ if book_odd else ‘‘}" >
<div class="card-body" id="card_body">
<h3 t-field="book.name"/>
<t t-if="book.date_release">
<div t-field="book.date_release" class="text-muted"/>
</t>
<b class="mt8"> Authors </b>
<ul>
<li t-foreach="book.author_ids" t-as="author">
<span t-esc="author.name" />
</li>
</ul>
</div>
</div>
</t>
</div>
4. 添加一个不可编辑的元素到website.layout，如下所示:
<section class="container mt16" contenteditable="False">
This is a non-editable text after the list of books.
</section>
5. 在controllers/main.py中添加一个提供图书列表的控制器，如下所示:
from odoo import http
from odoo.http import request
class Main(http.Controller):
@http.route(‘/books‘, type=‘http‘, auth="user", website=True)
def library_books(self):
return request.render(
‘my_library.books‘, {
‘books‘: request.env[‘library.book‘].search([]),
})
在浏览器中打开http://your-server-url:8069/books，您将能够看到图书列表以及作者。通过这段代码，用户可以看到图书列表及其详细信息。给予适当的权限，用户还将能够改变书的细节和一些其他文本。
它是如何工作的…
首先，我们创建了一个名为books的模板，用于生成显示图书列表所需的HTML。所有代码都包装在带有t-call属性集的t元素中，这使得Odoo使用website.layout模板呈现页面，并将我们的内容插入到模板中。website.layout包括所有必需的实用程序，比如Bootstrap、jQuery、FontAwesome等等。这些实用程序用于设计web页面。默认情况下，它包括所有必要的资产，如Bootstrap、jQuery、FontAwesome等等。website.layout还包括默认的页眉、页脚、代码片段和页面编辑功能。这样，我们就得到了一个完整的Odoo web页面，包括菜单、页脚和页面编辑功能，而不必在所有页面中重复这些代码。如果你不使用t-call="website_layout"，你将不会得到默认的页眉、页脚和网站编辑功能。
在website.layout中，我们添加了带有QWeb模板属性的HTML来显示图书列表。现在，我们将查看不同的QWeb属性及其用法。在此模板中，您将能够访问从main.py中控制器传递的参数。
Loop
为了处理记录集或可迭代数据类型，您需要一个结构来遍历列表。在QWeb模板中，这可以通过t-foreach元素完成。迭代可以发生在t 元素中，在这种情况下，它的内容会对t-foreach属性中传递的iterable的每个成员重复，如下所示:
<t t-foreach="[1, 2, 3, 4, 5]" t-as="num">
<p><t t-esc="num"/></p>
</t>
这将以如下方式呈现:
<p>1</p>
<p>2</p>
<p>3</p>
<p>4</p>
<p>5</p>
还可以将t-foreach和t-as属性放置在任意元素中，此时该元素及其内容将针对迭代中的每个项重复。看看下面的代码块。这将产生与前面例子完全相同的结果:
<p t-foreach="[1, 2, 3, 4, 5]" t-as="num">
<t t-esc="num"/>
</p>
在我们的示例中，看一下t-call元素的内部，这里发生了实际的内容生成。模板期望使用具有名为books set变量的上下文进行呈现，该变量在t-foreach元素中遍历该模板。t-as属性是强制性的，它将用作迭代器变量的名称，用于访问迭代数据。虽然这种构造最常见的用途是遍历记录集，但您可以在任何可迭代的Python对象上使用它。
在t-foreach循环中，您可以访问两个额外的变量，它们的名称派生于附带的t-as属性。正如前面示例中的book一样，我们可以访问book_odd变量，该变量在迭代时包含奇数索引的值为真，偶数索引的值为假。在这个例子中，我们使用这个可以在纸牌中交替使用背景颜色。
以下是其他可用的变量:
book_index，它返回迭代中的当前(从零开始)索引。
book_first和book_last:如果这是第一次或最后一次迭代，则book_first和book_last分别为真。
book_value，如果我们遍历的book变量是一个字典，它将包含条目的值;在本例中，book将遍历字典的键。
book_size，它是集合的大小(如果可用)。
book_even和book_odd根据迭代索引获得真值。
book_parity:迭代时包含偶数索引的偶数值，以及奇数索引的奇数值。
给出的例子是基于我们的例子。在您的例子中，需要用t-as属性处的值替换book。
QWeb template可以动态设置属性值。这可以通过以下三种方式来实现。
第一种方法是通过t-att-$attr_name。在模板呈现时，创建一个属性$attr_name;它的值可以是任何有效的Python表达式。这用当前上下文计算，结果设置为属性的值，如下所示:
<div t-att-total="10 + 5 + 5"/>
它将被渲染成这样:
<div total="20"></div>
第二种方法是通过t-attf-$attr_name。这与前面的选项相同。唯一的区别是只有字符串在{{..}}和#{…}是评估。当值与字符串混合时，这很有帮助。它主要用于评估类，如这个例子:
<t t-foreach="[‘info‘, ‘danger‘, ‘warning‘]" t-as="color">
<div t-attf-class="alert alert-#{color}">
Simple bootstrap alert
</div>
</t>
它将被渲染成这样:
<div class="alert alert-info">
Simple bootstrap alert
</div>
<div class="alert alert-danger">
Simple bootstrap alert
</div>
<div class="alert alert-warning">
Simple bootstrap alert
</div>
第三种方法是通过t-att=mapping选项。在呈现字典数据的模板被转换为属性和值之后，此选项接受字典。看看下面的例子:
<div t-att="{‘id‘: ‘my_el_id‘, ‘class‘: ‘alert alert-danger‘}"/>
该模板呈现后，将被转换为以下内容:
<div id="my_el_id" class="alert alert-danger"/>
在我们的示例中，我们使用t-attf-class来获得基于索引值的动态背景。
Fields
h3和div标记使用t字段属性。t-field属性的值必须用于长度为1的记录集，这允许用户在编辑模式下打开网站时更改web页面的内容。当您保存页面时，更新后的值将存储在数据库中。当然，这要经过权限检查，并且只有当前用户对显示的记录具有写权限时才允许。通过一个可选的t-options属性，您可以提供一个要传递给字段呈现器的dictionary选项，包括要使用的小部件。目前，后台并没有大量的小部件，所以这里的选择有点有限。例如，如果你想从二进制字段显示一个图像，那么你可以使用像这样的图像小部件:
<span t-field="author.image_small" t-options="{‘widget‘: ‘image‘}"/>
t-field有一些局限性。它只对记录集有效，对<t>元素无效。为此，需要使用一些HTML元素，如<span>或<div>。t字段属性还有一个可选属性，即t-esc。t-esc属性不限于记录集;它也可以用于任何数据类型，但不能在网站中编辑。
t-esc和t-field之间的另一个区别是，t-field显示基于用户语言的值，而t-esc显示来自数据库的原始值。例如，对于在首选项中配置了英语语言并将datetime字段设置为与t字段一起使用的用户，结果将以12/15/2018 17:12:13格式呈现。相反，如果使用t-esc属性，则结果将呈现如下格式:2018-12-15 16:12:13。
Conditionals
注意，显示发布日期的部分由带有t-if属性集的t元素包装。该属性作为Python代码计算，只有当结果是真实值时才呈现元素。在下面的示例中，我们只显示div类，如果确实设置了发布日期。但是，在复杂情况下，您可以使用t-elif和t-else，如下面的示例所示:
<div t-if="state == ‘new‘">
Text will be added of state is new.
</div>
<div t-elif="state == ‘progress‘">
Text will be added of state is progress.
</div>
<div t-else="">
Text will be added for all other stages.
</div>
Setting variables
QWeb模板还能够在模板本身中定义变量。定义模板之后，您可以在后续模板中使用该变量。你可以这样设置变量:
<t t-set="my_var" t-value="5 + 1"/>
<t t-esc="my_var"/>
Subtemplates(子模板)
如果您正在开发一个大型应用程序，管理大型模板可能会很困难。QWeb模板支持子模板，因此您可以将大型模板划分为较小的子模板，并且可以在多个模板中重用它们。对于子模板，你可以使用一个t-call属性，就像这个例子:
<template id="first_template">
<div> Test Template </div>
</template>
<template id="second_template">
<t t-call="first_template"/>
</template>
Inline editing(内联编辑)
用户可以在编辑模式下直接从网站修改记录。t字段节点加载的数据在默认情况下是可编辑的。如果用户更改了这样一个节点中的值并保存了页面，那么这些值也将在后端进行更新。别担心;为了更新记录，用户需要对记录进行写权限。注意，t字段只对记录集有效。要显示其他类型的数据，可以使用t-esc。它的工作原理与t-field完全相同，但唯一的区别是t-esc是不可编辑的，可以用于任何类型的数据。
注意，通过网站编辑器编辑视图会在此视图上设置noupdate标志。这意味着后续的代码更改将永远不会进入客户的数据库。为了更方便地使用内联编辑并在后续版本中更新HTML代码，创建一个包含语义HTML元素的视图和第二个注入可编辑元素的视图。然后，只有后一个视图是noupdate，您仍然可以更改前一个视图。
对于这里使用的其他CSS类，请参考Bootstrap文档，链接见本节的“参见”部分。
在步骤2中，我们声明了渲染模板的路由。如果您注意到，我们在route()中使用了website=True参数，它将在模板中传递一些额外的上下文，如菜单、用户语言、公司等等。这将用于网站。布局来呈现菜单和页脚。True参数也支持网站的多语言支持。它还以更好的方式显示异常。
在函数结束时，我们通过呈现模板返回结果;然后传递模板中使用的所有图书的记录集。有关更新现有路由的更多信息，请参考第14章“Web服务器开发”中的修改现有处理程序菜谱。
有更多的…
要修改现有模板，可以在模板上使用inherit_id属性，然后使用xpath元素，比如视图继承。例如，我们希望通过继承books模板来显示authors标签附近的作者数量。
我们可以通过以下方式做到这一点:
<!-- inheritance example -->
<template id="books_ids_inh" inherit_id="my_library.books">
<xpath expr="//div[@id=‘card_body‘]/b" position="replace">
<b class="mt8"> Authors (<t t-esc="len(book.author_ids)"/>) </b>
</xpath>
</template>
继承的工作原理与视图完全相同，因为在内部，QWeb模板是QWeb类型的普通视图。template元素是记录元素的简写，它为您在记录上设置一些属性。虽然没有理由不使用template元素的便利，但是您应该知道在幕后发生了什么:元素创建了一个具有qweb类型的ir.ui.view模型的记录。然后，根据模板元素的名称和inherit_id属性，将设置视图记录上的inherit_id字段。
另请参阅
要有效设计QWeb模板，请参考以下几点:
总的来说，Odoo广泛使用了Bootstrap (http://getbootstrap.com)，您应该使用它来轻松获得自适应设计。
有关视图继承的详细信息，请参阅第10章后端视图中的更改现有视图-视图继承。
关于控制器的更深入的讨论，请参考第14章“web服务器开发”中的“从网络创建一个可访问的路径并限制对web可访问路径的访问”。
管理动态路由
在网站开发项目中，经常需要创建带有动态url的页面。例如，在电子商务中，每个产品都有一个带有不同URL的详细页面。在这个章节中，我们将创建一个web页面来显示图书的详细信息。
准备
我们将使用上一个节中的my_library模块。为了使图书细节页面更吸引人，我们需要添加一些新字段。请在library.book模型中添加以下两个新字段并形成视图，如下所示:
class LibraryBook(models.Model):
_name = ‘library.book‘
name = fields.Char(‘Title‘, required=True)
date_release = fields.Date(‘Release Date‘)
author_ids = fields.Many2many(‘res.partner‘, string=‘Authors‘)
image = fields.Binary(attachment=True)
html_description = fields.Html()
怎么做呢?
按照以下步骤生成书籍的详细信息页面:
1. 在main.py中为图书详细信息添加一个新路由，如下所示:
@http.route(‘/books/<model("library.book"):book>‘, type=‘http‘, auth="user", website=True)
def library_book_detail(self, book):
return request.render(
‘my_library.book_detail‘, {
‘book‘: book,
})
2. 在templates.xml中添加一个新的图书详细信息模板，如下所示:
<!-- Book Detail Page -->
<template id="book_detail" name="Books Detail">
<t t-call="website.layout">
<div class="container">
<div class="row mt16">
<div class="col-5">
<span t-field="book.image" t-options="{‘widget‘: ‘image‘, ‘class‘: ‘mx-auto d-block img-thumbnail‘}"/>
</div>
<div class="offset-1 col-6">
<h1 t-field="book.name"/>
<t t-if="book.date_release">
<div t-field="book.date_release" class="text-muted"/>
</t>
<b class="mt8"> Authors </b>
<ul>
<li t-foreach="book.author_ids" t-as="author">
<span t-esc="author.name" />
</li>
</ul>
</div>
</div>
</div>
<div t-field="book.html_description"/>
</t>
</template>
3. 在book list模板中添加一个按钮，如下所示。此按钮将重定向到图书详情网页:
<template id="books">
<t t-call="website.layout">
<div class="oe_structure">
<section class="pt32 pb32 bg-secondary oe_custom_bg">
<div class="container text-center">
<h1> Editable text and supports drag and drop.</h1>
</div>
</section>
</div>
<div class="container">
<t t-foreach="books" t-as="book">
<div t-attf-class="card mt-3 #{‘bg-info‘ if book_odd else ‘‘}" >
<div class="card-body" id="card_body">
<h3 t-field="book.name"/>
<t t-if="book.date_release">
<div t-field="book.date_release" class="text-muted"/>
</t>
<b class="mt8"> Authors </b>
<ul>
<li t-foreach="book.author_ids" t-as="author">
<span t-esc="author.name" />
</li>
</ul>
<a t-attf-href="/books/#{book.id}" class="btn btn-primary btn-sm">
<i class="fa fa-book"/>
Book Detail
</a>
</div>
</div>
</t>
</div>
<section class="container mt16" contenteditable="False">
This is a non-editable text after the list of books.
</section>
</t>
</template>
它是如何工作的…
在第一步中，我们为图书详细信息页面创建了一个动态路径。在这个路径中，我们添加了<model("library.book"):book>。它接受带有整数的url，比如/books/1。Odoo认为这个整数是库的ID。当这个URL被访问时，Odoo获取一个记录集并将它作为参数传递给函数。因此，当从浏览器访问/books/1时，函数library_book_detail()中的book参数将拥有该库的一个记录集。ID为1的图书模型。我们传递了这个图书记录集，并呈现了一个名为my_library.book_detail的新模板。
在第二步中，我们创建了一个名为book_detail的新QWeb模板来呈现图书详细信息页面。这很简单，是使用引导结构创建的。如果您选中，我们已经在详细页面中添加了html_description。字段html_description有一个HTML类型的字段，因此您可以在字段中存储HTML数据。Odoo自动添加代码片段拖放支持的HTML类型的字段。所以，现在我们可以在book details页面中使用片段了。HTML字段中的代码片段存储在一本书的记录中，因此您可以为不同的图书设计不同的内容。
在最后一步中，我们添加了一个带有锚标记的链接，这样访问者就可以被重定向到图书详细信息页面。
有更多的…
Odoo使用werkzeug处理HTTP请求。Odoo在werkzeug周围增加了一个薄薄的包装纸，方便处理路线。您在最后一个示例中看到了<model(“library_book”):book>路由。这是Odoo自己的实现，但是它也支持所有来自werkzeug路由的特性。因此，你可以这样使用路由:
/page/<int:page> 接受整型值
/page/<any(about, help):page_name> 接受选择的值
/pages/<page> 接受字符串
/pages/<category>/<int:page> 接受多个值
路由有很多变体，您可以在http://werkzeug.pocoo.org/docs/0.14/routing/上了解到。
向用户提供代码片段
网站设计者在网站编辑模式中提供构建块，它可以在页面上。本节将介绍如何在内部提供自己的块(称为片段)。
准备
对于这个章节，我们将使用上一个章节中的my_library模块。
怎么做呢?
一个代码片段实际上就是一个注入到插入块栏中的qwebview，它是由QWeb view本身定义的。遵循以下步骤:
1. 添加名为views/snippets.xml的文件，如下所示:
<?xml version="1.0" encoding="UTF-8"?>
<odoo>
<!-- Assets for JS file added step 4 -->
<template id="assets_frontend" inherit_id="web.assets_frontend">
<xpath expr="." position="inside">
<script src="/my_library/static/src/js/snippets.js" type="text/JavaScript" />
</xpath>
</template>
<!-- Step 2 and 3 comes here -->
</odoo>
2. 为代码片段添加一个模板，如下所示:
<template id="book_snippet">
<section class="book_list">
<div class="container">
<h2>Latest books</h2>
<table class="table book_snippet">
<tr>
<th>Name</th>
<th>Release date</th>
</tr>
</table>
</div>
</section>
</template>
3.继承代码片段模板并附加代码片段和选项，如下所示:
<template id="book_snippets_options" inherit_id="website.snippets">
<xpath expr="//div[@id=‘snippet_feature‘]/div[hasclass(‘o_panel_body‘ )]" position="inside">
<t t-snippet="my_library.book_snippet" tthumbnail="/my_library/static/description/icon.png"/>
</xpath>
<xpath expr="//div[@id=‘snippet_options‘]" position="inside">
<!-- add snippet options here -->
</xpath>
</template>
4. 在继承的代码片段模板中添加代码片段选项，如下所示:
<div data-js="book_count" data-selector="section.book_list">
<div class="dropdown-submenu">
<a tabindex="-2" href="#" class="dropdown-item">
<i class="fa fa-book"/> Number of books
</a>
<div class="dropdown-menu" role="menu">
<a href="#" class="dropdown-item" data-selectcount="3"> 3 </a>
<a href="#" class="dropdown-item" data-selectcount="5"> 5 </a>
<a href="#" class="dropdown-item" data-selectcount="10"> 10 </a>
<a href="#" class="dropdown-item" data-selectcount="15"> 15 </a>
</div>
</div>
</div>
<div data-selector=".book_snippet">
<div class="dropdown-submenu">
<a tabindex="-2" href="#" class="dropdown-item">
<i class="fa fa-columns"/> Table Style
</a>
<div class="dropdown-menu" role="menu">
<a href="#" class="dropdown-item" data-toggleclass="table-bordered">
Bordered
</a>
<a href="#" class="dropdown-item" data-toggleclass="table-dark">
Dark
</a>
<a href="#" class="dropdown-item" data-toggleclass="table-striped">
Striped
</a>
</div>
</div>
</div>
5. 添加新文件/my_library/static/src/js/snippets.js，并添加JavaScript代码来填充我们的代码片段，如下所示:
odoo.define(‘my_library.snippets‘, function (require) {
"use strict";
var rpc = require(‘web.rpc‘);
var Animation = require(‘website.content.snippets.animation‘);
var options = require(‘web_editor.snippets.options‘);
// Add snippet option and animation JavaScript here
});
6. 添加如下选项来决定我们想要在代码片段中显示多少本书:
options.registry.book_count = options.Class.extend({
selectCount: function (previewMode, value, $opt) {
var table = this.$target.find(‘table‘);
var oldClass = table.attr(‘class‘);
var newTable = $(‘<table><tr><th>Name</th><th>Release date</th></tr></table>‘);
newTable.attr(‘class‘, oldClass);
newTable.attr(‘data-rows‘, value);
table.replaceWith(newTable);
this._refreshAnimations();
}
});
7. 添加动画来获取图书数据并显示在页面中，如下图所示:
Animation.registry.book_snippet = Animation.Class.extend({
selector: ‘.book_snippet‘,
start: function () {
var self = this;
var rows = this.$el.data().rows || 5;
this.$el.find(‘td‘).parents(‘tr‘).remove();
rpc.query({
model: ‘library.book‘, method: ‘search_read‘,
domain: [], fields: [‘name‘, ‘date_release‘],
orderBy: [{name: ‘date_release‘, asc: false}],
limit: rows,
}).then(function (data) {
_.each(data, function (book) {
self.$el.append(
$(‘<tr />‘).append(
$(‘<td />‘).text(book.name),
$(‘<td />‘).text(book.date_release)
));
});
});
},
});
在更新模块之后，将向您提供一个名为Latest books的新代码片段，其中有一个选项可以更改最近添加的图书数量。我们还添加了更改表设计的选项，可以在单击表时显示。
它是如何工作的…
在第一步中，我们添加了一个新的XML文件snipptes.xml，并在资源中添加了一个JS文件。代码片段只是没有website.layout的QWeb模板。
在第二步中，我们为该书创建了book_snippet模板。一般来说，使用section元素和引导类是一个好主意，因为对于它们，Odoo的编辑器提供了编辑、背景和调整大小的控制。在代码片段主体中，我们刚刚添加了标题和带有标题的表。我们想把最新的书陈列在我们的箱子里。最新的图书列表不是固定的，每次新书出版时，该列表都会更改。因此，我们希望动态地将图书详细信息插入到表中。在接下来的几个步骤中，我们将添加JavaScript来获取最新书籍列表并将它们添加到表中。
在第三步中，我们继承了website.snippet模板来添加代码片段及其选项。第一个xpath将book_snippet添加到feature snippet部分。要添加代码片段，需要使用t-snippet属性。您还需要添加t-thumbnail属性，它将是代码片段的缩略图的URL。使用position属性确定将在哪个部分显示代码片段。我们的选择是//div[@id=‘snippet_feature‘]/div[@class=‘o_panel_body‘]，这将它放在features部分中。使用snippet_structure、snippet_content和snippet_effect的id，您可以将代码片段放在其他相应的部分中。
在第二个xpath中，我们为代码片段添加了选项。通过步骤4在这个xpath中添加了两个选项。第一个选项用于选择要在表中显示的图书数量。代码片段选项有各种类型。在本例中，我们使用了data-js="book_count"的自定义选项。当使用data-js选项时，需要在options_registry中使用属性的值注册它。当用户更改选项时，它将调用已注册选项中的函数，然后您需要在元素上设置选项值。当页面被重新加载时，渲染函数(Odoo动画框架)会使用这些值。
您可以在步骤6中检查这一点，其中我们添加了选项，如options.registry.book_count。在函数体中，我们在this.$target中获得一个代码片段元素，函数体中的其余内容是用基本的JQuery语法编写的。
我们还在步骤4中添加了一个代码片段选项，用于更改表样式。对于这个选项，我们使用了data-toggle-class属性。当用户点击属性data-toggle-class的选项时，Odoo将切换属性值中给出的类。这种类型的选项不需要JavaScript代码。在Odoo中还有一种称为data-select-class的选项，它一次只支持一个类。我们在示例中没有使用这个，但您可以测试它。
如果您注意到，data-selector属性包含一个JQuery选择器，用于确定要显示选项的哪个元素。在本例中，第一个选项列表是在整个容器被选中时显示的，而第二个选项列表是在表被选中时显示的。
在步骤6和步骤7中，我们在Animation.registry中添加了book_snippet，它将从数据库中获取图书数据，并在snippet主体中追加表行。它使用代码片段动画框架在每次加载代码片段时执行代码。我们使用它来查询要呈现给用户的当前图书列表。这里的关键属性是已定义的选择器，它指示框架在有匹配选择器的元素时运行我们的类。在内部，我们使用data-rows选项，它是从options.registry.book.count添加的，用于确定需要显示多少行。
我们的章节中给出的示例用于创建动态片段。如果您不需要动态代码片段，而只想添加静态内容，那么您可以直接在代码片段中添加所有内容。不需要为静态片段添加JavaScript。
在前面的示例中，我们创建了一个动态代码片段。如果您不需要动态代码片段，而只想添加静态内容，那么您可以直接在代码片段中添加所有内容。在这种情况下，将不需要额外的JavaScript。
有更多的…
在这种情况下，将不需要额外的JavaScript。Odoo的编辑器提供了很多现成的选项和控制，对于静态代码片段来说，它们已经足够了。
你可以在website/views/snippets.xml找到所有现有的片段和选项。Snippet选项还支持data-exclude、data-drop-near和data-drop-in属性，这些属性决定在将Snippet拖出Snippet栏时可以将其放置在何处。这些也是JQuery选择器，在本节的第3步中，我们没有使用它们，因为我们允许将代码片段放到内容可以放到的任何地方。
从用户那里获取输入
在网站开发中，通常需要创建表单来获取网站用户(访问者)的输入。在这个章节中，我们将在页面中创建一个HTML表单来报告与书籍相关的问题。
准备
对于这个章节，我们将使用上一个章节中的my_library模块。我们将需要一个新的模型来存储用户提交的问题。因此，在开始此菜谱之前，请修改前面的代码。在库中添加一个字段。图书模型和新书。问题模型，如下:
class LibraryBook(models.Model):
_name = ‘library.book‘
name = fields.Char(‘Title‘, required=True)
date_release = fields.Date(‘Release Date‘)
author_ids = fields.Many2many(‘res.partner‘, string=‘Authors‘)
image = fields.Binary(attachment=True)
html_description = fields.Html()
book_issue_id = fields.One2many(‘book.issue‘, ‘book_id‘)
class LibraryBookIssues(models.Model):
_name = ‘book.issue‘
book_id = fields.Many2one(‘library.book‘, required=True)
submitted_by = fields.Many2one(‘res.users‘)
isuue_description = fields.Text()
在book表单视图中添加一个book_issues_id字段，如下所示:
...
<group string="Book Issues">
<field name="book_issue_id" nolabel="1">
<tree>
<field name="create_date"/>
<field name="submitted_by"/>
<field name="isuue_description"/>
</tree>
</field>
</group>
...
在ir.model.access.csv文件中为新 book.issue模型添加访问权限，如下:
acl_book_issues,library.book_issue,model_book_issue,group_librarian,1,1,1,1
我们已经为图书问题添加了一个新模型，现在，我们将添加一个带有HTML表单的新模板。
怎么做呢?
按照以下步骤为问题页面创建一个新的路由和模板页面:
1. 在main_py中添加一个新路由，如下所示:
@http.route(‘/books/submit_issues‘, type=‘http‘, auth="user", website=True)
def books_issues(self, **post):
if post.get(‘book_id‘):
book_id = int(post.get(‘book_id‘))
issue_description = post.get(‘issue_description‘)
request.env[‘book.issue‘].sudo().create({
‘book_id‘: book_id,
‘issue_description‘: issue_description,
‘submitted_by‘: request.env.user.id
})
return request.redirect(‘/books/submit_issues?submitted=1‘)
return request.render(‘my_library.books_issue_form‘, {
‘books‘: request.env[‘library.book‘].search([]),
‘submitted‘: post.get(‘submitted‘, False)
})
2. 添加一个带有HTML表单的模板，如下所示:
<template id="books_issue_form" name="Book Issues Form">
<t t-call="website.layout">
<div class="container mt32">
<!--第3步-->
<t t-if="submitted">
<h3 class="alert alert-success mt16 mb16">
<i class="fa fa-thumbs-up"/>
Book submitted successfully
</h3>
<h1> Report the another book issue </h1>
</t>
<t t-else="">
<h1> Report the book issue </h1>
</t>
<!--第４步-->
<div class="row mt16">
<div class="col-6">
<form method="post">
<input type="hidden" name="csrf_token" t-att-value="request.csrf_token()"/>
<div class="form-group">
<label>Select Book</label>
<select class="form-control" name="book_id">
<t t-foreach="books" t-as="book">
<option t-att-value="book.id">
<t t-esc="book.name"/>
</option>
</t>
</select>
</div>
<div class="form-group">
<label>Issue Description</label>
<textarea name="issue_description" class="form-control" placeholder="e.g. pages are missing"/>
</div>
<button type="submit" class="btn btn-primary">Submit</button>
</form>
</div>
</div>
</div>
</t>
</template>
3.为页面添加条件标题，如下所示:(第２步中的粗体)
<t t-if="submitted">
<h3 class="alert alert-success mt16 mb16">
<i class="fa fa-thumbs-up"/>
Book submitted successfully
</h3>
<h1> Report the another book issue </h1>
</t>
<t t-else="">
<h1> Report the book issue </h1>
</t>
4. 添加<form>提交问题如下: (第２步粗体)
<div class="row mt16">
<div class="col-6">
<form method="post">
<input type="hidden" name="csrf_token" t-att-value="request.csrf_token()"/>
<div class="form-group">
<label>Select Book</label>
<select class="form-control" name="book_id">
<t t-foreach="books" t-as="book">
<option t-att-value="book.id">
<t t-esc="book.name"/>
</option>
</t>
</select>
</div>
<div class="form-group">
<label>Issue Description</label>
<textarea name="issue_description" class="form-control" placeholder="e.g. pages are missing"/>
</div>
<button type="submit" class="btn btn-primary">Submit</button>
</form>
</div>
</div>
更新模块并打开/books/submit_issues URL。从这个页面，您可以提交这本书的问题。提交后，您可以在后台将它们签入相应的图书表单视图。
它是如何工作的…
在此章节的第1步中，我们创建了一个提交图书问题的路径。函数中的**post参数将接受URL中的所有查询参数。您还将在**post参数中获得提交的表单数据。在我们的示例中，我们使用了相同的控制器来显示页面并提交问题。如果我们发现数据后,我们将创建一个新的问题book.issue模型,然后将用户重定向到问题页面提交的查询参数,所以用户可以看到提交承认问题,因此可以提交另一个问题,如果他/她想要的。
注意，我们使用sudo()来创建一个图书发行记录，因为普通用户(访问者)没有创建新的图书发行记录的访问权限。尽管如果用户从web页面提交了一个问题，仍然需要创建图书发行记录。这是使用sudo()的一个实际示例。
在步骤2中，我们已经为问题页面创建了模板。
在步骤3中，我们添加了条件标题。成功标头将在提交问题后显示。
在步骤4中，我们添加了带有三个字段的<form>: csrf_token、图书选择和问题描述。最后两个字段用于获取网站用户的输入。但是，csrf_token用于避免跨站点请求伪造(CSRF)攻击。如果不在表单中使用它，用户将无法提交表单。当您提交表单时，您将在第1步的books_issues()方法中获得作为**post参数的提交数据。
在某些情况下，如果您想禁用csrf验证，您可以在路由中使用csrf=False，如下所示:
@http.route(‘/url‘, type=‘http‘,auth="user",website=True, csrf=False )
有更多的…
如果你想，你可以使用单独的路由页面和post数据，你可以在表单中添加操作如下:
...
<form action="/my_url" method="post">
...
此外，您可以通过在路由中添加方法参数来限制get请求，如下所示:
@http.route(‘/my_url‘, type=‘http‘, method=‘POST‘ auth="user",website=True)
管理搜索引擎优化(SEO)选项
Odoo为模板(页面)提供内置的SEO支持。然而，有些模板在多个url中使用。例如，在在线商店中，产品页面使用相同的模板和不同的产品数据呈现。对于这类情况，我们希望每个URL都有单独的SEO选项。
准备
对于这个章节，我们将使用上一个章节中的my_library模块。我们将为每个图书详细信息页面存储单独的SEO数据。在开发此章节之前，您应该在不同的图书页面中测试SEO选项。你可以从顶部的“提升”下拉菜单中得到一个SEO对话框，如下图所示:
如果您在不同的图书详细信息页面中测试SEO选项，您将注意到更改一个图书页面中的SEO数据将反映在所有图书页面上。我们将在这个章节中解决这个问题。
怎么做呢?
为每本书管理单独的SEO选项，遵循以下步骤:
1. 在library_book模型中继承SEO元数据mixin，如下所示:
class LibraryBook(models.Model):
_name = ‘library.book‘
_description = ‘Library Book‘
_inherit = [‘website.seo.metadata‘]
name = fields.Char(‘Title‘, required=True)
date_release = fields.Date(‘Release Date‘)
author_ids = fields.Many2many(‘res.partner‘, string=‘Authors‘)
image = fields.Binary(attachment=True)
html_description = fields.Html()
book_issue_ids = fields.One2many(‘book.issue‘, ‘book_id‘)
def _default_website_meta(self):
res = super(LibraryBook, self)._default_website_meta()
res[‘default_opengraph‘][‘og:image‘] = self.env[‘website‘].image_url(self, ‘image‘)
res[‘default_twitter‘][‘twitter:image‘] = self.env[‘website‘].image_url(self, ‘image‘)
return res
2. 在图书详细信息路由中以main_object的形式传递图书对象，如下所示:
@http.route(‘/books/<model("library.book"):book>‘, type=‘http‘, auth="user", website=True, sitemap=sitemap_books)
def library_book_detail(self, book):
return request.render(
‘my_library.book_detail‘, {
‘book‘: book,
‘main_object‘: book
})
更新模块和改变不同的图书页面的SEO。它可以通过优化SEO选项来改变。现在，您将能够管理每本书单独的SEO细节。
它是如何工作的…
要在模型的每个记录上启用SEO，您需要在模型中继承website.seo.metadata 。这将在library.book模型中添加一些字段和方法。网站将使用这些字段和方法为每本书存储单独的数据。
如果你想看到SEO mixin的字段和方法，在/addons/website/models/website.py文件中搜索website.seo.metadata模型。
所有与SEO相关的代码都写在website.layout中，它从传入main_object的记录集中获取所有SEO元信息。因此，在第2步中，我们传递了一个带有main_object键的book对象，这样网站布局就会从这本书中获得所有SEO信息。如果您没有从控制器传递main_object，那么模板记录集将作为main_object传递，这就是为什么您在所有书籍中获得相同的SEO数据的原因。
有更多的…
Odoo v12增加了对开放Graph和Twitter共享的元标签的支持。如果您想在页面中添加您的自定义meta标签，您可以在添加SEO mixin之后覆盖_default_website_meta()。
一个网站的网站地图对任何一个网站都是至关重要的。搜索引擎将使用网站网站地图来索引网站的页面。在这个章节中，我们将在网站地图中添加图书详细信息页面。
准备……
对于这个章节，我们将使用上一个章节中的my_library模块。如果你想在Odoo中检查当前的站点地图，请在浏览器中打开<your_odoo_server_url> /sitemap_xml。这将没有书的URL。
怎么做呢?
按照以下步骤将图书页面添加到sitemap.xml:
1. 导入main.py中给定的方法，如下所示:
from odoo.addons.http_routing.models.ir_http import slug
from odoo.addons.website.models.ir_http import sitemap_qs2dom
2. 在main.py中添加sitemap_books方法，如下所示:
class Main(http.Controller):
@http.route(‘/books‘, type=‘http‘, auth="user", website=True)
def library_books(self):
country_id = False
country_code = request.session.geoip and request.session.geoip.get(‘country_code‘) or False
if country_code:
country_ids = request.env[‘res.country‘].sudo().search([(‘code‘, ‘=‘, country_code)])
if country_ids:
country_id = country_ids[0].id
domain = [‘|‘, (‘restrict_country_ids‘, ‘=‘, False), (‘restrict_country_ids‘, ‘not in‘, [country_id])]
return request.render(
‘my_library.books‘, {
‘books‘: request.env[‘library.book‘].search([]),
})
def sitemap_books(env, rule, qs):
Books = env[‘library.book‘]
dom = sitemap_qs2dom(qs, ‘/books‘, Books._rec_name)
for f in Books.search(dom):
loc = ‘/books/%s‘ % slug(f)
if not qs or qs.lower() in loc:
yield {‘loc‘: loc}
@http.route(‘/books/<model("library.book"):book>‘, type=‘http‘, auth="user", website=True, sitemap=sitemap_books)
def library_book_detail(self, book):
return request.render(
‘my_library.book_detail‘, {
‘book‘: book,
‘main_object‘: book
})
@http.route(‘/books/submit_issues‘, type=‘http‘, auth="user", website=True)
def books_issues(self, **post):
if post.get(‘book_id‘):
book_id = int(post.get(‘book_id‘))
issue_description = post.get(‘issue_description‘)
request.env[‘book.issue‘].sudo().create({
‘book_id‘: book_id,
‘issue_description‘: issue_description,
‘submitted_by‘: request.env.user.id
})
return request.redirect(‘/books/submit_issues?submitted=1‘)
return request.render(‘my_library.books_issue_form‘, {
‘books‘: request.env[‘library.book‘].search([]),
‘submitted‘: post.get(‘submitted‘, False)
})
3.在图书的详细路由中添加sitemap_books函数引用，如下所示:
...
@http.route(‘/books/<model("library.book"):book>‘,type=‘http‘, auth="user", website=True,sitemap=sitemap_books)
def library_book_detail(self, book):
...
更新模块以应用更改。sitemap.xml文件被生成并存储在附件中。然后，它每隔几个小时再生一次。要查看我们的更改，您需要从附件中删除sitemap文件。为此，请访问设置|技术|数据库结构|附件，搜索站点地图，并删除该文件。现在，在浏览器中访问/sitemap.xml URL，您将在站点地图中看到该书的页面。
它是如何工作的…
在第一步中，我们导入了一些必需的函数。slug用于根据一个记录名称生成一个干净的、用户友好的URL。sitemap_qs2dom用于根据路由和查询字符串生成域。
在第2步中，我们创建了一个Python生成器函数sitemap_books()。每当生成站点地图时，都会调用此函数。在调用期间，它将接收三个参数——env Odoo环境、rule路由规则和qs查询字符串。在函数中，我们已经用sitemap_qs2dom生成了一个域。然后，使用生成的域搜索图书记录，通过slug()方法生成位置。使用slug，您将获得一个用户友好的URL，如/books/ oddoo -12-development-cookbook-1，而不是books/1。
在第3步中，我们将sitemap_books()函数引用传递给带有关键字站点地图的路由。
Odoo CMS内置了对GeoIP的支持。在实时环境中，您可以基于IP跟踪访问者的国家。在这个章节中，我们将根据访问者的IP地址获得访问者的国家。
准备……
对于这个章节，我们将使用上一个章节中的my_library模块。在这个章节中，我们将根据访问者的国家在网页中隐藏一些书籍。您需要下载GeoIP数据库。之后，您需要从cli选项中传递数据库位置，如下所示:
./odoo-bin -c config_file --geoip-db=location_of_geoip_DB
1. 在library.book模型中添加restrict_country_ids m2m字段，如下所示:
class LibraryBook(models.Model):
_name = ‘library.book‘
_description = ‘Library Book‘
_inherit = [‘website.seo.metadata‘]
name = fields.Char(‘Title‘, required=True)
date_release = fields.Date(‘Release Date‘)
author_ids = fields.Many2many(‘res.partner‘, string=‘Authors‘)
image = fields.Binary(attachment=True)
html_description = fields.Html()
book_issue_ids = fields.One2many(‘book.issue‘, ‘book_id‘)
restrict_country_ids = fields.Many2many(‘res.country‘)
......
2. 在library.books模型的表单视图中添加一个restrict_country_ids字段，如下所示:
...
<group>
<field name="date_release"/>
<field name="restrict_country_ids" widget="many2many_tags"/>
</group>
...
3.更新/books控制器以根据国家限制图书，如下所示:
class Main(http.Controller):
@http.route(‘/books‘, type=‘http‘, auth="user", website=True)
def library_books(self):
country_id = False
country_code = request.session.geoip and request.session.geoip.get(‘country_code‘) or False
if country_code:
country_ids = request.env[‘res.country‘].sudo().search([(‘code‘, ‘=‘, country_code)])
if country_ids:
country_id = country_ids[0].id
domain = [‘|‘, (‘restrict_country_ids‘, ‘=‘, False), (‘restrict_country_ids‘, ‘not in‘, [country_id])]
return request.render(
‘my_library.books‘, {
‘books‘: request.env[‘library.book‘].search([]),
})
......
更新模块以应用更改。在图书的受限国家字段中添加您的国家，以及access /book。这将不会显示列表中的受限制书籍。
警告:此章节不适用于本地服务器。它将需要一个托管服务器，因为在本地机器中，您将获得本地IP，这与任何国家都没有关系。
您还需要正确配置nginx。
它是如何工作的…
在第一步中，我们在library.book模型中添加了一个新的restricted_country_ids many2many类型字段。如果网站访问者来自受限国家，我们将把书藏起来。
在步骤2中，我们刚刚在图书的表单视图中添加了一个restricted_country_ids字段。如果GeoIP和NGINX配置正确，Odoo会在request.session.geoip添加GeoIP信息，然后你可以从中获得国家代码。
在第三步中，我们从GeoIP获取了国家代码，然后根据country_code获取了国家的记录集。在获得访问者的国家信息后，我们根据受限制的国家使用域名过滤图书。
如果你没有真正的服务器，你想要测试它，你可以在控制器中添加一个默认的国家代码，像这样:country_code = request.session.geoip和request.session.geoip.get(‘country_code‘)或‘ IN‘
在任何业务或服务中，熟悉投资回报(ROI)是非常重要的。ROI用于评估投资的效率。广告投资可以通过Urchin跟踪模块(UTM)代码进行跟踪。UTM代码是一个可以添加到URL中的小字符串。此UTM代码将帮助您跟踪活动、资源和媒体。
准备
对于这个章节，我们将使用上一个章节中的my_library模块。Odoo内置了对UTMs的支持。对于我们的库应用程序，我们没有任何使用UTMs的实际案例。但是，在这个章节中，我们将在my_library中的/books/submit_issues生成的问题中添加UTM。
怎么做呢?
按照以下步骤链接由/books/submit_issues URL上的web页面生成的图书问题中的UTMs:
1. 在manifest.py的depends部分添加一个utm模块，如下:
‘depends‘: [‘base‘, ‘website‘, ‘utm‘],
2. 在书中继承utm.mixin。发行模式如下:
class LibraryBookIssues(models.Model):
_name = ‘book.issue‘
_inherit = [‘utm.mixin‘]
book_id = fields.Many2one(‘library.book‘, required=True)
submitted_by = fields.Many2one(‘res.users‘)
issue_description = fields.Text()
3.在book_issue_ids字段的树形视图中添加一个campaign_id字段，如下所示:
...
<group string="Book Issues">
<field name="book_issue_ids" nolabel="1">
<tree name="Book isuues">
<field name="create_date"/>
<field name="submitted_by"/>
<field name="issue_description"/>
<field name="campaign_id"/>
</tree>
</field>
</group>
...
更新模块以应用更改。要测试UTM，您需要执行以下步骤:
它是如何工作的…
在第一步中，我们在book.issue模型中继承了utm.mixin。这将向book.issue模型添加以下字段:
campaign_id: utm.campaign模型中的Many2one字段。这是用来跟踪不同的活动，如夏季和圣诞节特辑。
source_id: utm.source模型中的Many2one字段。这是用来跟踪不同的来源，如搜索引擎和其他域。
medium_id: utm.medium模型中的Many2one字段。这是用来跟踪不同的媒体，如明信片，电子邮件，或横幅广告。
要跟踪活动、媒体和来源，你需要在营销媒体中共享一个URL，如下:your_url?utm_campaign=campaign_name&utm_medium=medium_name&utm_source=source_name
如果访问者从任何营销媒体访问您的网站，那么当在网站页面上创建记录时，campaign_id、source_id和medium_id字段将自动填充。
在我们的示例中，我们只跟踪了campaign_id，但是还可以添加source_id和medium_id。
注意:在我们的测试示例中，我们使用了campaign_id=sale。sale是模型utm_campaign中记录的名称。默认情况下，utm模块会添加一些活动、媒体和来源的记录。唱片销售就是其中之一。如果你想创建一个新的活动，媒体和源代码，你可以在开发者模式下访问Link Tracker > UTMs菜单。
在v12中，Odoo增加了对多个网站的支持。这意味着同一个Odoo实例可以在多个域上运行，也可以在显示不同记录时运行。
准备
对于这个章节，我们将使用上一个章节中的my_library模块。在这个章节中，我们将会隐藏基于网站的书籍。
怎么做呢?
按照以下步骤，使网上网站-多网站兼容:
1. 在library.book模型中添加website.multi.mixin，如下所示:
class LibraryBook(models.Model):
_name = ‘library.book‘
_inherit = [‘website.seo.metadata‘, ‘website.multi.mixin‘]
...
2. 在图书表单视图中添加website_id，如下所示:
...
<group>
<field name="author_ids" widget="many2many_tags"/>
<field name="website_id"/>
</group>
...
3.修改/books控制器中的域，如下所示:
@http.route(‘/books‘, type=‘http‘, auth="user", website=True)
def library_books(self, **post):
...
domain = [‘|‘, (‘restrict_country_ids‘, ‘=‘, False),(‘restrict_country_ids‘, ‘not in‘, [country_id])]
domain += request.website.website_domain()
return request.render(
‘my_library.books‘, {
‘books‘:
request.env[‘library.book‘].search(domain),
})
...
4. 导入werkzeug，修改book details控制器，限制从另一个网站访问图书，如下:
...
@http.route(‘/books/<model("library.book"):book>‘,type=‘http‘, auth="user", website=True, sitemap=sitemap_books)
def library_book_detail(self, book, **post):
if not book.can_access_from_current_website():
raise werkzeug.exceptions.NotFound()
return request.render(
‘my_library.book_detail‘, {
‘book‘: book,
‘main_object‘: book
})
...
更新模块以应用更改。为了测试这个模块，在一些书中设置不同的网站。现在，打开/books URL并检查图书列表。在这之后，改变网站和检查图书列表。对于测试，您可以从“网站切换器”下拉菜单中更改网站。请参考下面的截图:
您还可以尝试直接从URL(如/books/1)访问图书详细信息。如果一本书不是来自该网站，它将显示为404。
它是如何工作的…
在第一步中，我们添加了website.multi.mixin。这个mixin添加了一个基本实用程序来处理模型中的多个网站。这个mixin在模型中添加website_id字段。该字段用于确定记录用于哪个网站。
在第2步中，我们在图书的表单视图中添加了website_id字段，因此图书将根据网站进行过滤。
在步骤3中，我们修改了用于查找图书列表的域。request.website.website_domain()将返回一个域，该域将过滤掉不来自该网站的图书。
请注意，有些记录没有设置任何website_id。这些记录将在所有网站上显示。这意味着，如果某本书没有website_id字段，那么该图书将显示在所有网站上。
然后，我们在web搜索中添加域名，如下:
在步骤4中，我们限制了图书访问。如果这本书不是为当前的网站，那么我们将提出一个未发现的错误。can_access_from_current_website()方法将返回值True，如果图书记录用于当前活动的网站，则返回值为True;如果图书记录用于另一个网站，则返回值为False。
如果勾选，我们已经在两个控制器中添加了**post。这是因为没有它，**post /books和/books/<model:library_book:book>;将不接受查询参数。当从网站切换器切换网站时，它也会产生一个错误，所以我们添加了它。通常，在每个控制器中添加**post是一个很好的实践，这样它就可以处理查询参数。
标签：registry func 转换 bottom 之间 文档 nav views release
原文地址：https://www.cnblogs.com/ly-stranger/p/13877751.html
