...
Table of Contents | ||
---|---|---|
|
1. Extracting guide data (JSON)
To get started you first need to create your guides on CLOUD (lmw.technia.cloud). This requires the latest Light My Way extension that can either be installed from Chrome/Edge store https://technia.jira.com/wiki/spaces/TSD/pages/4031971409/Light+My+Way+-+Product+Documentation#Client-Installation or self-hosted 2. Self hosting client (web-extension).
...
Light My Way will then load all guide data from the export file and the extension will not connect to CLOUD.
2. Self-hosting client (web extension)
To self-host the extension you need to host two files (3 with the JSON data file)
the update file (e.g.
update.xml
)the extension package (e.g.
lmw-2024.2.crx
).
The files needs to be hosted over HTTPS (Reference: https://developer.chrome.com/docs/extensions/how-to/distribute/host-on-linux#update). We recommend hosting these together with the guide data JSON (there is a version dependency).
Extension package
The extension package (.crx) can be downloaded from products.technia.com.
Update file
The update file (.xml) needs to be edited according to how its hosted.
In below example these values needs to be updated:
<updatecheck codebase='path-to-extension.crx
' version='version (must match extension version)
' />
Example:
Code Block | ||
---|---|---|
| ||
<?xml version='1.0' encoding='UTF-8'?>
<gupdate xmlns='http://www.google.com/update2/response' protocol='2.0'>
<app appid='abgmfmhjplgnlmjoglbgddpdnfdcjenj'>
<updatecheck codebase='https://<YOUR_HOSTING_URL>/lmw-2024.2.crx' version='2024.2' />
</app>
</gupdate> |
Please refer to this page on more details about the elements of the update file.
Learn more
Web Extension self-hosting is supported technology for Chrome and MS Edge.
Please refer to browser documentation for more information.
Chrome https://developer.chrome.com/docs/extensions/how-to/distribute
MS Edgehttps://learn.microsoft.com/en-us/deployedge/microsoft-edge-manage-extensions-webstore.
3. Distribution
Self hosted extensions can be distributed just like the Chrome Store hosted extension using the registry https://technia.jira.com/wiki/spaces/TSD/pages/4031971409/Light+My+Way+-+Product+Documentation#Registry-entries-using-file.
The registry file also needs to be edited with the correct values and path to the update file.
In below example these values would need to be updated:
update_url
runtime_allowed_hosts
hosted-guides-path
Example:
Code Block |
---|
Windows Registry Editor Version 5.00
[HKEY_LOCAL_MACHINE\SOFTWARE\Policies\Google\Chrome\ExtensionSettings\abgmfmhjplgnlmjoglbgddpdnfdcjenj]
"installation_mode"="normal_installed"
"update_url"="https://<YOUR_HOSTING_URL>/update.xml"
"runtime_allowed_hosts"="[\"https://lmw.technia.cloud\",\"://example.com\",\"://*.3ds.com\"]"
"runtime_blocked_hosts"="[\"*://*\"]"
[HKEY_LOCAL_MACHINE\SOFTWARE\Policies\Google\Chrome\3rdparty\extensions\abgmfmhjplgnlmjoglbgddpdnfdcjenj\policy]
"hosted-guides-path"="https://<YOUR_HOSTING_URL>/data-export.json"
"lmw-server-url-editable"=dword:00000001
"lmw-author-mode"=dword:00000000
"lmw-registry-script-executed"=dword:00000000 |