<spanid="evennia-web-admin-comms"></span><h1>evennia.web.admin.comms<aclass="headerlink"href="#module-evennia.web.admin.comms"title="Permalink to this headline">¶</a></h1>
<p>This defines how Comm models are displayed in the web admin interface.</p>
<dlclass="py class">
<dtid="evennia.web.admin.comms.MsgTagInline">
<emclass="property">class </em><codeclass="sig-prename descclassname">evennia.web.admin.comms.</code><codeclass="sig-name descname">MsgTagInline</code><spanclass="sig-paren">(</span><emclass="sig-param"><spanclass="n">parent_model</span></em>, <emclass="sig-param"><spanclass="n">admin_site</span></em><spanclass="sig-paren">)</span><aclass="reference internal"href="../_modules/evennia/web/admin/comms.html#MsgTagInline"><spanclass="viewcode-link">[source]</span></a><aclass="headerlink"href="#evennia.web.admin.comms.MsgTagInline"title="Permalink to this definition">¶</a></dt>
<codeclass="sig-name descname">model</code><aclass="headerlink"href="#evennia.web.admin.comms.MsgTagInline.model"title="Permalink to this definition">¶</a></dt>
<dd><p>alias of <codeclass="xref py py-class docutils literal notranslate"><spanclass="pre">evennia.comms.models.Msg_db_tags</span></code></p>
<codeclass="sig-name descname">related_field</code><emclass="property"> = 'msg'</em><aclass="headerlink"href="#evennia.web.admin.comms.MsgTagInline.related_field"title="Permalink to this definition">¶</a></dt>
<emclass="property">property </em><codeclass="sig-name descname">media</code><aclass="headerlink"href="#evennia.web.admin.comms.MsgTagInline.media"title="Permalink to this definition">¶</a></dt>
<dd></dd></dl>
</dd></dl>
<dlclass="py class">
<dtid="evennia.web.admin.comms.MsgForm">
<emclass="property">class </em><codeclass="sig-prename descclassname">evennia.web.admin.comms.</code><codeclass="sig-name descname">MsgForm</code><spanclass="sig-paren">(</span><emclass="sig-param">data=None</em>, <emclass="sig-param">files=None</em>, <emclass="sig-param">auto_id='id_%s'</em>, <emclass="sig-param">prefix=None</em>, <emclass="sig-param">initial=None</em>, <emclass="sig-param">error_class=<class 'django.forms.utils.ErrorList'></em>, <emclass="sig-param">label_suffix=None</em>, <emclass="sig-param">empty_permitted=False</em>, <emclass="sig-param">instance=None</em>, <emclass="sig-param">use_required_attribute=None</em>, <emclass="sig-param">renderer=None</em><spanclass="sig-paren">)</span><aclass="reference internal"href="../_modules/evennia/web/admin/comms.html#MsgForm"><spanclass="viewcode-link">[source]</span></a><aclass="headerlink"href="#evennia.web.admin.comms.MsgForm"title="Permalink to this definition">¶</a></dt>
<emclass="property">class </em><codeclass="sig-name descname">Meta</code><aclass="reference internal"href="../_modules/evennia/web/admin/comms.html#MsgForm.Meta"><spanclass="viewcode-link">[source]</span></a><aclass="headerlink"href="#evennia.web.admin.comms.MsgForm.Meta"title="Permalink to this definition">¶</a></dt>
<codeclass="sig-name descname">models</code><aclass="headerlink"href="#evennia.web.admin.comms.MsgForm.Meta.models"title="Permalink to this definition">¶</a></dt>
<dd><p>alias of <aclass="reference internal"href="evennia.comms.models.html#evennia.comms.models.Msg"title="evennia.comms.models.Msg"><codeclass="xref py py-class docutils literal notranslate"><spanclass="pre">evennia.comms.models.Msg</span></code></a></p>
<codeclass="sig-name descname">fields</code><emclass="property"> = '__all__'</em><aclass="headerlink"href="#evennia.web.admin.comms.MsgForm.Meta.fields"title="Permalink to this definition">¶</a></dt>
<codeclass="sig-name descname">declared_fields</code><emclass="property"> = {'db_header': <django.forms.fields.CharField object>, 'db_lock_storage': <django.forms.fields.CharField object>}</em><aclass="headerlink"href="#evennia.web.admin.comms.MsgForm.declared_fields"title="Permalink to this definition">¶</a></dt>
<dd></dd></dl>
<dlclass="py method">
<dtid="evennia.web.admin.comms.MsgForm.media">
<emclass="property">property </em><codeclass="sig-name descname">media</code><aclass="headerlink"href="#evennia.web.admin.comms.MsgForm.media"title="Permalink to this definition">¶</a></dt>
<dd><p>Return all media required to render the widgets on this form.</p>
</dd></dl>
</dd></dl>
<dlclass="py class">
<dtid="evennia.web.admin.comms.MsgAdmin">
<emclass="property">class </em><codeclass="sig-prename descclassname">evennia.web.admin.comms.</code><codeclass="sig-name descname">MsgAdmin</code><spanclass="sig-paren">(</span><emclass="sig-param"><spanclass="n">model</span></em>, <emclass="sig-param"><spanclass="n">admin_site</span></em><spanclass="sig-paren">)</span><aclass="reference internal"href="../_modules/evennia/web/admin/comms.html#MsgAdmin"><spanclass="viewcode-link">[source]</span></a><aclass="headerlink"href="#evennia.web.admin.comms.MsgAdmin"title="Permalink to this definition">¶</a></dt>
<codeclass="sig-name descname">inlines</code><emclass="property"> = [<class 'evennia.web.admin.comms.MsgTagInline'>]</em><aclass="headerlink"href="#evennia.web.admin.comms.MsgAdmin.inlines"title="Permalink to this definition">¶</a></dt>
<dd></dd></dl>
<dlclass="py attribute">
<dtid="evennia.web.admin.comms.MsgAdmin.form">
<codeclass="sig-name descname">form</code><aclass="headerlink"href="#evennia.web.admin.comms.MsgAdmin.form"title="Permalink to this definition">¶</a></dt>
<dd><p>alias of <aclass="reference internal"href="#evennia.web.admin.comms.MsgForm"title="evennia.web.admin.comms.MsgForm"><codeclass="xref py py-class docutils literal notranslate"><spanclass="pre">MsgForm</span></code></a></p>
<codeclass="sig-name descname">list_display_links</code><emclass="property"> = ('id', 'db_date_created', 'start_of_message')</em><aclass="headerlink"href="#evennia.web.admin.comms.MsgAdmin.list_display_links"title="Permalink to this definition">¶</a></dt>
<codeclass="sig-name descname">ordering</code><emclass="property"> = ['-db_date_created', '-id']</em><aclass="headerlink"href="#evennia.web.admin.comms.MsgAdmin.ordering"title="Permalink to this definition">¶</a></dt>
<codeclass="sig-name descname">readonly_fields</code><emclass="property"> = ['db_date_created', 'serialized_string']</em><aclass="headerlink"href="#evennia.web.admin.comms.MsgAdmin.readonly_fields"title="Permalink to this definition">¶</a></dt>
<dd></dd></dl>
<dlclass="py attribute">
<dtid="evennia.web.admin.comms.MsgAdmin.save_as">
<codeclass="sig-name descname">save_as</code><emclass="property"> = True</em><aclass="headerlink"href="#evennia.web.admin.comms.MsgAdmin.save_as"title="Permalink to this definition">¶</a></dt>
<codeclass="sig-name descname">save_on_top</code><emclass="property"> = True</em><aclass="headerlink"href="#evennia.web.admin.comms.MsgAdmin.save_on_top"title="Permalink to this definition">¶</a></dt>
<codeclass="sig-name descname">list_select_related</code><emclass="property"> = True</em><aclass="headerlink"href="#evennia.web.admin.comms.MsgAdmin.list_select_related"title="Permalink to this definition">¶</a></dt>
<codeclass="sig-name descname">view_on_site</code><emclass="property"> = False</em><aclass="headerlink"href="#evennia.web.admin.comms.MsgAdmin.view_on_site"title="Permalink to this definition">¶</a></dt>
<codeclass="sig-name descname">sender</code><spanclass="sig-paren">(</span><emclass="sig-param"><spanclass="n">obj</span></em><spanclass="sig-paren">)</span><aclass="reference internal"href="../_modules/evennia/web/admin/comms.html#MsgAdmin.sender"><spanclass="viewcode-link">[source]</span></a><aclass="headerlink"href="#evennia.web.admin.comms.MsgAdmin.sender"title="Permalink to this definition">¶</a></dt>
<codeclass="sig-name descname">receiver</code><spanclass="sig-paren">(</span><emclass="sig-param"><spanclass="n">obj</span></em><spanclass="sig-paren">)</span><aclass="reference internal"href="../_modules/evennia/web/admin/comms.html#MsgAdmin.receiver"><spanclass="viewcode-link">[source]</span></a><aclass="headerlink"href="#evennia.web.admin.comms.MsgAdmin.receiver"title="Permalink to this definition">¶</a></dt>
<codeclass="sig-name descname">start_of_message</code><spanclass="sig-paren">(</span><emclass="sig-param"><spanclass="n">obj</span></em><spanclass="sig-paren">)</span><aclass="reference internal"href="../_modules/evennia/web/admin/comms.html#MsgAdmin.start_of_message"><spanclass="viewcode-link">[source]</span></a><aclass="headerlink"href="#evennia.web.admin.comms.MsgAdmin.start_of_message"title="Permalink to this definition">¶</a></dt>
<codeclass="sig-name descname">serialized_string</code><spanclass="sig-paren">(</span><emclass="sig-param"><spanclass="n">obj</span></em><spanclass="sig-paren">)</span><aclass="reference internal"href="../_modules/evennia/web/admin/comms.html#MsgAdmin.serialized_string"><spanclass="viewcode-link">[source]</span></a><aclass="headerlink"href="#evennia.web.admin.comms.MsgAdmin.serialized_string"title="Permalink to this definition">¶</a></dt>
<dd><p>Get the serialized version of the object.</p>
<codeclass="sig-name descname">get_form</code><spanclass="sig-paren">(</span><emclass="sig-param"><spanclass="n">request</span></em>, <emclass="sig-param"><spanclass="n">obj</span><spanclass="o">=</span><spanclass="default_value">None</span></em>, <emclass="sig-param"><spanclass="o">**</span><spanclass="n">kwargs</span></em><spanclass="sig-paren">)</span><aclass="reference internal"href="../_modules/evennia/web/admin/comms.html#MsgAdmin.get_form"><spanclass="viewcode-link">[source]</span></a><aclass="headerlink"href="#evennia.web.admin.comms.MsgAdmin.get_form"title="Permalink to this definition">¶</a></dt>
<dd><p>Overrides help texts.</p>
</dd></dl>
<dlclass="py method">
<dtid="evennia.web.admin.comms.MsgAdmin.media">
<emclass="property">property </em><codeclass="sig-name descname">media</code><aclass="headerlink"href="#evennia.web.admin.comms.MsgAdmin.media"title="Permalink to this definition">¶</a></dt>
<emclass="property">class </em><codeclass="sig-prename descclassname">evennia.web.admin.comms.</code><codeclass="sig-name descname">ChannelAttributeInline</code><spanclass="sig-paren">(</span><emclass="sig-param"><spanclass="n">parent_model</span></em>, <emclass="sig-param"><spanclass="n">admin_site</span></em><spanclass="sig-paren">)</span><aclass="reference internal"href="../_modules/evennia/web/admin/comms.html#ChannelAttributeInline"><spanclass="viewcode-link">[source]</span></a><aclass="headerlink"href="#evennia.web.admin.comms.ChannelAttributeInline"title="Permalink to this definition">¶</a></dt>
<codeclass="sig-name descname">model</code><aclass="headerlink"href="#evennia.web.admin.comms.ChannelAttributeInline.model"title="Permalink to this definition">¶</a></dt>
<dd><p>alias of <codeclass="xref py py-class docutils literal notranslate"><spanclass="pre">evennia.comms.models.ChannelDB_db_attributes</span></code></p>
<codeclass="sig-name descname">related_field</code><emclass="property"> = 'channeldb'</em><aclass="headerlink"href="#evennia.web.admin.comms.ChannelAttributeInline.related_field"title="Permalink to this definition">¶</a></dt>
<emclass="property">property </em><codeclass="sig-name descname">media</code><aclass="headerlink"href="#evennia.web.admin.comms.ChannelAttributeInline.media"title="Permalink to this definition">¶</a></dt>
<dd></dd></dl>
</dd></dl>
<dlclass="py class">
<dtid="evennia.web.admin.comms.ChannelTagInline">
<emclass="property">class </em><codeclass="sig-prename descclassname">evennia.web.admin.comms.</code><codeclass="sig-name descname">ChannelTagInline</code><spanclass="sig-paren">(</span><emclass="sig-param"><spanclass="n">parent_model</span></em>, <emclass="sig-param"><spanclass="n">admin_site</span></em><spanclass="sig-paren">)</span><aclass="reference internal"href="../_modules/evennia/web/admin/comms.html#ChannelTagInline"><spanclass="viewcode-link">[source]</span></a><aclass="headerlink"href="#evennia.web.admin.comms.ChannelTagInline"title="Permalink to this definition">¶</a></dt>
<codeclass="sig-name descname">model</code><aclass="headerlink"href="#evennia.web.admin.comms.ChannelTagInline.model"title="Permalink to this definition">¶</a></dt>
<dd><p>alias of <codeclass="xref py py-class docutils literal notranslate"><spanclass="pre">evennia.comms.models.ChannelDB_db_tags</span></code></p>
<codeclass="sig-name descname">related_field</code><emclass="property"> = 'channeldb'</em><aclass="headerlink"href="#evennia.web.admin.comms.ChannelTagInline.related_field"title="Permalink to this definition">¶</a></dt>
<emclass="property">property </em><codeclass="sig-name descname">media</code><aclass="headerlink"href="#evennia.web.admin.comms.ChannelTagInline.media"title="Permalink to this definition">¶</a></dt>
<dd></dd></dl>
</dd></dl>
<dlclass="py class">
<dtid="evennia.web.admin.comms.ChannelForm">
<emclass="property">class </em><codeclass="sig-prename descclassname">evennia.web.admin.comms.</code><codeclass="sig-name descname">ChannelForm</code><spanclass="sig-paren">(</span><emclass="sig-param">data=None</em>, <emclass="sig-param">files=None</em>, <emclass="sig-param">auto_id='id_%s'</em>, <emclass="sig-param">prefix=None</em>, <emclass="sig-param">initial=None</em>, <emclass="sig-param">error_class=<class 'django.forms.utils.ErrorList'></em>, <emclass="sig-param">label_suffix=None</em>, <emclass="sig-param">empty_permitted=False</em>, <emclass="sig-param">instance=None</em>, <emclass="sig-param">use_required_attribute=None</em>, <emclass="sig-param">renderer=None</em><spanclass="sig-paren">)</span><aclass="reference internal"href="../_modules/evennia/web/admin/comms.html#ChannelForm"><spanclass="viewcode-link">[source]</span></a><aclass="headerlink"href="#evennia.web.admin.comms.ChannelForm"title="Permalink to this definition">¶</a></dt>
<emclass="property">class </em><codeclass="sig-name descname">Meta</code><aclass="reference internal"href="../_modules/evennia/web/admin/comms.html#ChannelForm.Meta"><spanclass="viewcode-link">[source]</span></a><aclass="headerlink"href="#evennia.web.admin.comms.ChannelForm.Meta"title="Permalink to this definition">¶</a></dt>
<codeclass="sig-name descname">model</code><aclass="headerlink"href="#evennia.web.admin.comms.ChannelForm.Meta.model"title="Permalink to this definition">¶</a></dt>
<dd><p>alias of <aclass="reference internal"href="evennia.comms.models.html#evennia.comms.models.ChannelDB"title="evennia.comms.models.ChannelDB"><codeclass="xref py py-class docutils literal notranslate"><spanclass="pre">evennia.comms.models.ChannelDB</span></code></a></p>
<codeclass="sig-name descname">fields</code><emclass="property"> = '__all__'</em><aclass="headerlink"href="#evennia.web.admin.comms.ChannelForm.Meta.fields"title="Permalink to this definition">¶</a></dt>
<codeclass="sig-name descname">declared_fields</code><emclass="property"> = {'db_lock_storage': <django.forms.fields.CharField object>}</em><aclass="headerlink"href="#evennia.web.admin.comms.ChannelForm.declared_fields"title="Permalink to this definition">¶</a></dt>
<emclass="property">property </em><codeclass="sig-name descname">media</code><aclass="headerlink"href="#evennia.web.admin.comms.ChannelForm.media"title="Permalink to this definition">¶</a></dt>
<dd><p>Return all media required to render the widgets on this form.</p>
</dd></dl>
</dd></dl>
<dlclass="py class">
<dtid="evennia.web.admin.comms.ChannelAdmin">
<emclass="property">class </em><codeclass="sig-prename descclassname">evennia.web.admin.comms.</code><codeclass="sig-name descname">ChannelAdmin</code><spanclass="sig-paren">(</span><emclass="sig-param"><spanclass="n">model</span></em>, <emclass="sig-param"><spanclass="n">admin_site</span></em><spanclass="sig-paren">)</span><aclass="reference internal"href="../_modules/evennia/web/admin/comms.html#ChannelAdmin"><spanclass="viewcode-link">[source]</span></a><aclass="headerlink"href="#evennia.web.admin.comms.ChannelAdmin"title="Permalink to this definition">¶</a></dt>
<codeclass="sig-name descname">inlines</code><emclass="property"> = [<class 'evennia.web.admin.comms.ChannelTagInline'>, <class 'evennia.web.admin.comms.ChannelAttributeInline'>]</em><aclass="headerlink"href="#evennia.web.admin.comms.ChannelAdmin.inlines"title="Permalink to this definition">¶</a></dt>
<codeclass="sig-name descname">form</code><aclass="headerlink"href="#evennia.web.admin.comms.ChannelAdmin.form"title="Permalink to this definition">¶</a></dt>
<dd><p>alias of <aclass="reference internal"href="#evennia.web.admin.comms.ChannelForm"title="evennia.web.admin.comms.ChannelForm"><codeclass="xref py py-class docutils literal notranslate"><spanclass="pre">ChannelForm</span></code></a></p>
<codeclass="sig-name descname">list_display_links</code><emclass="property"> = ('id', 'db_key')</em><aclass="headerlink"href="#evennia.web.admin.comms.ChannelAdmin.list_display_links"title="Permalink to this definition">¶</a></dt>
<codeclass="sig-name descname">ordering</code><emclass="property"> = ['-db_date_created', '-id', '-db_key']</em><aclass="headerlink"href="#evennia.web.admin.comms.ChannelAdmin.ordering"title="Permalink to this definition">¶</a></dt>
<codeclass="sig-name descname">search_fields</code><emclass="property"> = ['id', 'db_key', 'db_tags__db_key']</em><aclass="headerlink"href="#evennia.web.admin.comms.ChannelAdmin.search_fields"title="Permalink to this definition">¶</a></dt>
<codeclass="sig-name descname">readonly_fields</code><emclass="property"> = ['serialized_string']</em><aclass="headerlink"href="#evennia.web.admin.comms.ChannelAdmin.readonly_fields"title="Permalink to this definition">¶</a></dt>
<codeclass="sig-name descname">save_as</code><emclass="property"> = True</em><aclass="headerlink"href="#evennia.web.admin.comms.ChannelAdmin.save_as"title="Permalink to this definition">¶</a></dt>
<codeclass="sig-name descname">save_on_top</code><emclass="property"> = True</em><aclass="headerlink"href="#evennia.web.admin.comms.ChannelAdmin.save_on_top"title="Permalink to this definition">¶</a></dt>
<codeclass="sig-name descname">list_select_related</code><emclass="property"> = True</em><aclass="headerlink"href="#evennia.web.admin.comms.ChannelAdmin.list_select_related"title="Permalink to this definition">¶</a></dt>
<codeclass="sig-name descname">raw_id_fields</code><emclass="property"> = ('db_object_subscriptions', 'db_account_subscriptions')</em><aclass="headerlink"href="#evennia.web.admin.comms.ChannelAdmin.raw_id_fields"title="Permalink to this definition">¶</a></dt>
<codeclass="sig-name descname">subscriptions</code><spanclass="sig-paren">(</span><emclass="sig-param"><spanclass="n">obj</span></em><spanclass="sig-paren">)</span><aclass="reference internal"href="../_modules/evennia/web/admin/comms.html#ChannelAdmin.subscriptions"><spanclass="viewcode-link">[source]</span></a><aclass="headerlink"href="#evennia.web.admin.comms.ChannelAdmin.subscriptions"title="Permalink to this definition">¶</a></dt>
<dd><p>Helper method to get subs from a channel.</p>
<dlclass="field-list simple">
<dtclass="field-odd">Parameters</dt>
<ddclass="field-odd"><p><strong>obj</strong> (<em>Channel</em>) – The channel to get subs from.</p>
<codeclass="sig-name descname">no_of_subscribers</code><spanclass="sig-paren">(</span><emclass="sig-param"><spanclass="n">obj</span></em><spanclass="sig-paren">)</span><aclass="reference internal"href="../_modules/evennia/web/admin/comms.html#ChannelAdmin.no_of_subscribers"><spanclass="viewcode-link">[source]</span></a><aclass="headerlink"href="#evennia.web.admin.comms.ChannelAdmin.no_of_subscribers"title="Permalink to this definition">¶</a></dt>
<dd><p>Get number of subs for a a channel .</p>
<dlclass="field-list simple">
<dtclass="field-odd">Parameters</dt>
<ddclass="field-odd"><p><strong>obj</strong> (<em>Channel</em>) – The channel to get subs from.</p>
<codeclass="sig-name descname">serialized_string</code><spanclass="sig-paren">(</span><emclass="sig-param"><spanclass="n">obj</span></em><spanclass="sig-paren">)</span><aclass="reference internal"href="../_modules/evennia/web/admin/comms.html#ChannelAdmin.serialized_string"><spanclass="viewcode-link">[source]</span></a><aclass="headerlink"href="#evennia.web.admin.comms.ChannelAdmin.serialized_string"title="Permalink to this definition">¶</a></dt>
<dd><p>Get the serialized version of the object.</p>
<codeclass="sig-name descname">get_form</code><spanclass="sig-paren">(</span><emclass="sig-param"><spanclass="n">request</span></em>, <emclass="sig-param"><spanclass="n">obj</span><spanclass="o">=</span><spanclass="default_value">None</span></em>, <emclass="sig-param"><spanclass="o">**</span><spanclass="n">kwargs</span></em><spanclass="sig-paren">)</span><aclass="reference internal"href="../_modules/evennia/web/admin/comms.html#ChannelAdmin.get_form"><spanclass="viewcode-link">[source]</span></a><aclass="headerlink"href="#evennia.web.admin.comms.ChannelAdmin.get_form"title="Permalink to this definition">¶</a></dt>
<codeclass="sig-name descname">save_model</code><spanclass="sig-paren">(</span><emclass="sig-param"><spanclass="n">request</span></em>, <emclass="sig-param"><spanclass="n">obj</span></em>, <emclass="sig-param"><spanclass="n">form</span></em>, <emclass="sig-param"><spanclass="n">change</span></em><spanclass="sig-paren">)</span><aclass="reference internal"href="../_modules/evennia/web/admin/comms.html#ChannelAdmin.save_model"><spanclass="viewcode-link">[source]</span></a><aclass="headerlink"href="#evennia.web.admin.comms.ChannelAdmin.save_model"title="Permalink to this definition">¶</a></dt>
<codeclass="sig-name descname">response_add</code><spanclass="sig-paren">(</span><emclass="sig-param"><spanclass="n">request</span></em>, <emclass="sig-param"><spanclass="n">obj</span></em>, <emclass="sig-param"><spanclass="n">post_url_continue</span><spanclass="o">=</span><spanclass="default_value">None</span></em><spanclass="sig-paren">)</span><aclass="reference internal"href="../_modules/evennia/web/admin/comms.html#ChannelAdmin.response_add"><spanclass="viewcode-link">[source]</span></a><aclass="headerlink"href="#evennia.web.admin.comms.ChannelAdmin.response_add"title="Permalink to this definition">¶</a></dt>
<dd><p>Determine the HttpResponse for the add_view stage.</p>
<emclass="property">property </em><codeclass="sig-name descname">media</code><aclass="headerlink"href="#evennia.web.admin.comms.ChannelAdmin.media"title="Permalink to this definition">¶</a></dt>