Search 1.9 billion lines of Odoo code on GitHub
web_debranding
<a class="reference external image-reference" href="https://www.gnu.org/licenses/lgpl"><img alt="License: LGPL-3" src="https://img.shields.io/badge/license-LGPL--3-blue.png" /></a>
<a name="backend-debranding"></a>
<h2>Backend debranding</h2>
<p>Removes references to odoo.com:</p>
<ol class="arabic">
<li><p class="first">Deletes Odoo label in footer, i.e.</p>
<blockquote>
<p>Powered by Odoo</p>
</blockquote>
</li>
<li><p class="first">Replaces "Odoo" in page title</p>
</li>
<li><p class="first">Replaces "Odoo" in help message for empty list.</p>
<p>Some list views has word Odoo when search return empty result. E.g. search random string at menu <code>[[ Settings ]] >> Users & Companies >> Companies</code> that return empty result -- it has Odoo word</p>
<blockquote>
<p>Create and manage the companies that will be managed by <strong>Odoo</strong> from here. Shops or subsidiaries can be created and maintained from here.</p>
</blockquote>
</li>
<li><p class="first"><em>(feature is not required in 9.0+ versions)</em></p>
</li>
<li><p class="first">Deletes <em>Documentation</em>, <em>Support</em>, <em>My Odoo.com account</em>; adds <em>Developer mode</em>, <em>Developer mode (with assets)</em> links to the top right-hand User Menu.</p>
</li>
<li><p class="first"><em>(feature is not required in 11.0+ versions)</em></p>
</li>
<li><p class="first">Replaces "Odoo" in Dialog Box</p>
<p>E.g. try to remove Administrator via menu <code>[[ Settings ]] >> Users & Companies >> Users</code>. It will show warning</p>
<blockquote>
<p>You can not remove the admin user as it is used internally for resources created by <strong>Odoo</strong> (updates, module installation, ...)</p>
</blockquote>
</li>
<li><p class="first">Replaces "Odoo" in strings marked for translation.</p>
<p>This provides a big part of debranding. You can find examples at menu <code>[[ Settings ]] >> General Settings</code>:</p>
<blockquote>
<p>Use external pads in <strong>Odoo</strong> Notes</p>
<p>Extract and analyze <strong>Odoo</strong> data from Google Spreadsheet</p>
</blockquote>
<p>Full list of debranded phrases can be found at menu <code>[[ Settings ]] >> Translations >> Application Terms</code> (You may need to click <code>Generate Missing Terms</code> first).</p>
</li>
<li><p class="first">Replaces default favicon to a custom one</p>
</li>
<li><p class="first"><strong>Hides Apps menu</strong>. By default, only superuser can see Apps menu. You can change it via setting <em>Apps access</em> in a user form.</p>
</li>
<li><p class="first">Disables server requests to odoo.com (publisher_warranty_url) - optional. Works only for non-enterprise versions of odoo, check <a class="reference external" href="#enterprise-users-notice">note</a> below.</p>
</li>
<li><p class="first"><em>(feature is a part of p.5)</em></p>
</li>
<li><p class="first">Deletes Share block and branded parts of other blocks at <code>[[ Settings ]] >> Dashboard</code></p>
</li>
<li><p class="first"><em>(feature is not required in 12.0+ versions)</em></p>
</li>
<li><p class="first"><em>(feature is not required in 12.0+ versions)</em></p>
</li>
<li><p class="first">Deletes "Odoo" in a request message for permission desktop notifications (yellow block at <code>Discuss</code> page). Replaces "Odoo" and icon in desktop notifications</p>
</li>
<li><p class="first">[ENTERPRISE] Deletes odoo logo in application switcher</p>
</li>
<li><p class="first">Hides Enterprise features in Settings</p>
</li>
<li><p class="first">Replaces "Odoo" in all backend qweb templates</p>
<p>This provides a big part of debranding. You can find examples at menu <code>[[ Invoicing ]] >> Dashboard >> Reconcile 5 items >> 'Automatic reconcilation' button title on hover</code></p>
<blockquote>
<p>Let <strong>odoo</strong> try to reconcile entries for the user</p>
</blockquote>
</li>
<li><p class="first">Replaces "odoo.com" in hints, examples, etc.</p>
<p>For example, when you create new company it shows placeholder for field <em>Website</em></p>
<blockquote>
<p>e.g. www.odoo.com</p>
</blockquote>
</li>
<li><p class="first">Renames "OdooBot" to "Bot". Use company's logo as bot avatar</p>
<p>To receive a message from the Bot open menu <code>[[ Discuss ]] >> CHANNELS >> #general</code> and send <code>/help</code> to the chat.</p>
</li>
<li><p class="first">[ENTERPRISE] Replaces icons for mobile devices with custom url</p>
</li>
<li><p class="first">Replaces links to <a class="reference external" href="https://www.odoo.com/documentation">documentation</a> (e.g. "Help" in Import tool, "How-to" in paypal, etc.) to custom website</p>
</li>
<li><p class="first"><em>(feature is not required in 12.0+ versions)</em></p>
</li>
<li><p class="first"><em>(feature is not required in 12.0+ versions)</em></p>
</li>
</ol>
<a name="configuration"></a>
<h3>Configuration</h3>
<p>By default the module replaces "Odoo" to "Software". To configure
module openf <code>[[ Settings ]] >> Technical >> Parameters >> System Parameters</code> and modify</p>
<ul class="simple">
<li><code>web_debranding.new_title</code> (put space in value if you don't need Brand in Title)</li>
<li><code>web_debranding.new_name</code> (your Brand)</li>
<li><code>web_debranding.new_website</code> (your website)</li>
<li><code>web_debranding.new_documentation_website</code> (website with documentation instead of official one)</li>
<li><code>web_debranding.favicon_url</code></li>
<li><code>web_debranding.send_publisher_warranty_url</code> - set 0 to disable server requests to odoo.com and 1 otherwise (useful for enterprise contractors). Works only for non-enterprise versions of odoo, check <a class="reference external" href="#enterprise-users-notice">note</a> below.</li>
<li><code>web_debranding.icon_url</code> - icon for mobile devices. recommended size :192x192</li>
<li><code>web_debranding.apple_touch_icon_url</code> - icon for IOS Safari. recommended size :152x152</li>
</ul>
<p>Note. More user friendly way to configure the module is available in <a class="reference external" href="https://apps.odoo.com/apps/modules/11.0/theme_kit/">Brand Kit</a>.</p>
<a name="further-debranding"></a>
<h3>Further debranding</h3>
<ul class="simple">
<li>open addons/mail/data/mail_data.xml and edit Template "Notification Email" -- delete "using Odoo"</li>
<li>open addons/website_livechat/data/website_livechat_data.xml and edit in "im_livechat_channel_data_website" record YourWebsiteWithOdoo.com string</li>
<li>install <strong>website_debranding</strong> module if module "Website Builder" is installed in your system</li>
<li>install <strong>pos_debranding</strong> module if module "POS" is installed in your system</li>
<li>delete "Odoo.com Accounts" record at Settings\Users & Companies\OAuth Providers if module "OAuth2 Authentication" is installed in your system</li>
<li>to debrand <strong>/web/database/manager</strong>:<ul>
<li>edit addons/web/views/database_manager.html file:<ul>
<li>delete or modify <title> tag</li>
<li>delete or modify favicon</li>
<li>delete or modify <img> tag with logo2.png</li>
<li>delete or modify paragraph <p>Odoo is up and running! <br /> ...</p></li>
<li>delete or modify warning <div class="alert alert-warning">Warning, your Odoo database ...</div></li>
</ul>
</li>
</ul>
</li>
</ul>
<a name="auto-debrand-new-databases"></a>
<h3>Auto-debrand new databases</h3>
<p>To automatically install this module for every new databases set <strong>'auto_install': True</strong> in __openerp__.py files of following modules:</p>
<ul class="simple">
<li>web_debranding</li>
<li>ir_rule_protected</li>
<li>access_restricted</li>
<li>access_apps</li>
<li>access_settings_menu</li>
<li>mail (built-in)</li>
<li>base_setup (built-in)</li>
<li>bus (built-in)</li>
</ul>
<p>Tested on Odoo 12.0 edd8bad5d97ee489e85504791c807f0099ef24b5</p>
<a name="enterprise-users-notice"></a>
<h3>Enterprise users notice</h3>
<ul class="simple">
<li><a class="reference external" href="https://www.odoo.com/documentation/user/12.0/legal/terms/enterprise.html#customer-obligations">Terms of Odoo Enterprise Subscription Agreement</a> don't allow to disable server requests to odoo.com. For this reason feature #11 doesn't work in Enterprise version.</li>
</ul>
<a name="note"></a>
<h3>Note</h3>
<ul class="simple">
<li>You can also use our new extended <a class="reference external" href="https://www.odoo.com/apps/modules/11.0/theme_kit">Brand Kit module</a> to brand your odoo instance and create your theme in few clicks.</li>
</ul>
<a name="need-our-service"></a>
<h3>Need our service?</h3>
<p>Contact us by <a class="reference external" href="mailto:apps@it-projects.info">email</a> or fill out <a class="reference external" href="https://www.it-projects.info/page/website.contactus">request form</a>:</p>
<ul class="simple">
<li><a class="reference external" href="mailto:apps@it-projects.info">apps@it-projects.info</a></li>
<li><a class="reference external" href="https://www.it-projects.info/page/website.contactus">https://www.it-projects.info/page/website.contactus</a></li>
</ul>