<div>Wouldn’t the points about HTML apply just as equally to the existing ShortPromo key ?</div><div><br></div><div>Some front-ends already jump to the URL specified in the href, and can open a browser to do so.&nbsp;</div><div><br></div><div>David</div><div><br></div><div id="protonmail_mobile_signature_block">Sent from ProtonMail Mobile</div> <div><br></div><div><br></div>On Sun, Dec 30, 2018 at 00:39, Jaak Ristioja &lt;<a href="mailto:jaak@ristioja.ee" class="">jaak@ristioja.ee</a>&gt; wrote:<blockquote class="protonmail_quote" type="cite">  I like the idea, because it is useful information for the users. Here<br>are some of the thoughts I gathered for this:<br><br><br>&lt;brainstorm xmlns="https://en.wikipedia.org/wiki/Brainstorming"&gt;<br><br>Why can't the About= entry contain this information?<br><br>I'm unsure whether "UnlockInfo" is the best name.<br><br>Is it safe to assume that this entry will only be relevant for modules<br>with a CipherKey= entry?<br><br>Using HTML might be a can of worms:<br>* What version of HTML is permitted?<br>* How do we ensure future-compatibility?<br>* If the contents for the UnlockInfo field are to contain a segment of<br>HTML (and not a whole HTML document), what is the content model?<br>  * For example, would it be safe to embed the contents of the<br>UnlockInfo field directly inside a &lt;td&gt; element or should it be a &lt;p&gt;?<br>  * Can UnlockInfo= contain<br>&lt;img&gt;/&lt;audio&gt;/&lt;video&gt;/&lt;object&gt;/&lt;embed&gt;/&lt;script&gt; etc elements?<br>  * How about attributes, e.g. &lt;strong<br>style='background:url("http://track.me/I_consent")'&gt; or &lt;span<br>onClick="doBadStuff()"&gt;?<br><br>Modules can originate from untrusted sources. I think it might be a bit<br>too much to assume that all frontends can properly sanitize the HTML<br>value, unless we only allow a very restricted subset of the HTML syntax,<br>e.g. only plain text, HTML entities and &lt;a&gt; elements only one allowed<br>and mandatory href attribute. Note that &lt;b&gt; and &lt;i&gt; etc are discouraged<br>in HTML5, &lt;u&gt; was completely redefined. Will &lt;a&gt; ("anchor") still be<br>valid in HTML6 or will &lt;link&gt; be repurposed for hyperlinks as well?<br><br>Hence I suggest to use a simple URL (or URI, RFC 3986) instead of HTML.<br>Simple documents (including HTML pages, PDF or any other types of files)<br>could be embedded using the data: URI scheme (RFC 2397). Frontends could<br>pass the URI to the OS/desktop/browser to be opened or attempt to<br>display the information inline (e.g. show a web view widget for<br>HTTP/HTTPS URIs or similar). Optionally, frontends can display a<br>warning/confirmation dialog to the user before opening the URI.<br><br>Perhaps it would be wiser to have two fields: one for the URI and<br>another for plain text? I currently have no suggestions for the exact<br>semantics of naming of such entries, but both of these could be<br>displayed by frontends. The plain text could be a description of the<br>URI, or contain full information about obtaining the key. One or both of<br>the entries could be optional. Frontends could opt to detect URLs in the<br>plain text as well and render these as hyperlinks.<br><br>Or perhaps we should use a subset of markdown or similar instead?<br>However, other markup languages could suffer from problems similar to HTML.<br><br>&lt;/brainstorm&gt;<br><br><br>J<br><br><br>On 30.12.18 00:02, Troy A. Griffitts wrote:<br>&gt; Dear Frontend Developers,<br>&gt;<br>&gt; In an effort to gain more publishers-- even those who desire to lock and<br>&gt; sell some of their modules, I would like to add a new .conf entry:<br>&gt;<br>&gt; UnlockInfo<br>&gt;<br>&gt; Up until now, we've relied on the About entry containing something that<br>&gt; lets the user know how to obtain unlock codes from publishers selling<br>&gt; codes to unlock their modules.&nbsp; This entry would isolate just those<br>&gt; instructions to a specific entry and would allow a frontend to do<br>&gt; something like:<br>&gt;<br>&gt; If (moduleToInstall.getConfEntry("UnlockInfo")) {<br>&gt;<br>&gt; &nbsp; showDialog("&lt;p&gt;The publisher of this modules requires for you to<br>&gt; obtain an unlock code.&nbsp; This code can be entered below, instructions<br>&gt; from the publisher are as follows:&lt;/p&gt;" +<br>&gt; moduleToInstall.getConfEntry("UnlockInfo"));<br>&gt;<br>&gt; }<br>&gt;<br>&gt; Like many of our entries, this new UnlockInfo entry will allow HTML<br>&gt; links and will likely contain a direct link from the publisher to their<br>&gt; store entry to purchase an unlock code.<br>&gt;<br>&gt; An example would be something like:<br>&gt;<br>&gt; UnlockInfo=An unlock code for the Larry Fitzgerald NFL HOF Edition of<br>&gt; the New Testament, with memorable career moments encouraging the<br>&gt; believer to press on when those around fall short, may be obtained<br>&gt; directly from the NFL store here: &lt;a target="_blank"<br>&gt; href="https://nfl.com/shop/lf-nfl-hof-nt-sword-module"&gt;Larry Fitzgerald<br>&gt; NFL HOF Edition of the New Testament - SWORD Module&lt;/a&gt;<br>&gt;<br>&gt; Let me know if you have any comments or ideas,<br>&gt;<br>&gt; Troy<br>&gt;<br>&gt;<br>&gt;<br>&gt; _______________________________________________<br>&gt; sword-devel mailing list: sword-devel@crosswire.org<br>&gt; http://www.crosswire.org/mailman/listinfo/sword-devel<br>&gt; Instructions to unsubscribe/change your settings at above page<br>&gt;<br><br><br>_______________________________________________<br>sword-devel mailing list: sword-devel@crosswire.org<br>http://www.crosswire.org/mailman/listinfo/sword-devel<br>Instructions to unsubscribe/change your settings at above page</blockquote><div><br></div><div><br></div>