高级特性

这些高级特性大多数在oTree Studio中不被支持。

附加模型

当单个玩家就需要存储几十上百个数据点时,附加模型非常有用。例如存在一系列出价,刺激与反馈时。这常与 实时页面 一起使用。

这里 有很多例子。

一个附加模型应当链接到另一个模型上:

class Bid(ExtraModel):
    player = models.Link(Player)
    amount = models.CurrencyField()

每当用户出价时,将其存到数据库中:

Bid.create(player=player, amount=500)

之后,你就可以提取出玩家出价的列表:

bids = Bid.filter(player=player)

一个附加模型可以有多个链接:

class Offer(ExtraModel):
    sender = models.Link(Player)
    receiver = models.Link(Player)
    group = models.Link(Group)
    amount = models.CurrencyField()
    accepted = models.BooleanField()

此时你就可以以多种方式查询:

this_group_offers = Offer.filter(group=group)
offers_i_accepted = Offer.filter(receiver=player, accepted=True)

对于更加复杂的过滤与排序,你应当使用列表操作:

offers_over_500 = [o for o in Offer.filter(group=group) if o.amount > 500]

参考心理学实验的例子,如斯特鲁普测试,它们展示了如何从CSV表格中的每一行中生成附加模型的数据。

To export your ExtraModel data to CSV/Excel, use 自定义数据导出.

模板

template_name

如果模板需要有一个与你的页面类不同的名字(例如你在不同的页面中共享同一模板),设置 template_name 即可。例如:

class Page1(Page):
    template_name = 'app_name/MyPage.html'

CSS/JS 与基模板

为将相同的JS/CSS包含在一个应用的所有页面中,可将其放入一个 static file 中,也可将其放入一个可包含的模板。

静态文件

下面说明了如何在页面中包含图片(或任何静态文件如.css, .js,等等)。

在你的oTree项目的根文件夹中,有一个 _static/ 文件夹。将文件放在这里,例如 puppy.jpg.然后,在你的模板中,你可以通过 {{ static 'puppy.jpg' }} 获取文件的URL。

要显示图片,使用 <img> 标签,如:

<img src="{{ static 'puppy.jpg' }}"/>

上面我们将文件保存在 _static/puppy.jpg,但是实际上更好的做法是创建一个子文件夹,起名为你应用的名字,并存为 _static/your_app_name/puppy.jpg ,这使得文件组织有条理,并避免了名字冲突。

此时你的HTML代码变为:

<img src="{{ static 'your_app_name/puppy.jpg }}"/>

(如果你愿意的话,你也可以将静态文件放入你的应用文件夹,在子文件夹 static/your_app_name 中。)

如果静态文件在你更改了之后仍不改变,这是因为你的浏览器缓存了这个文件。重载整个页面即可(通常快捷键是 Ctrl+F5)

如果你需要视频或者高解析度的图片,更好的做法是将其存储在线上别的地方并使用URL进行引用。因为大文件使得上传 .otreezip文件非常缓慢。

等待页面

自定义等待页面模板

你可以自定义等待页面模板。例如,存为 your_app_name/templates/your_app_name/MyWaitPage.html:

{{ extends 'otree/WaitPage.html' }}
{{ block title }}{{ title_text }}{{ endblock }}
{{ block content }}
    {{ body_text }}
    <p>
        My custom content here.
    </p>
{{ endblock }}

然后在等待页面中使用这一模板:

class MyWaitPage(WaitPage):
    template_name = 'your_app_name/MyWaitPage.html'

此时你可以如寻常一样使用 vars_for_template 。实际上, body_texttitle_text 属性就是设置 vars_for_template 的简略方式;下面两段代码是等价的:

class MyWaitPage(WaitPage):
    body_text = "foo"
class MyWaitPage(WaitPage):

    @staticmethod
    def vars_for_template(player):
        return dict(body_text="foo")

如果你想全局应用你的自定义等待页面模板,将其保存在 _templates/global/WaitPage.html.oTree将自动地在所有地方使用它替换内置的等待页面。

货币

为将”points”自定义为别的名字如”tokens” 或 “credits”, 设置 POINTS_CUSTOM_NAME ,例如 POINTS_CUSTOM_NAME = 'tokens'.

你可以改变真实世界货币的小数位数,通过设置 REAL_WORLD_CURRENCY_DECIMAL_PLACES。如果额外的小数位数显示出来但总是0,那么你应当重置数据库。