Rietveld Code Review Tool
Help | Bug tracker | Discussion group | Source code

Unified Diff: README.md

Issue 6180766664884224: Issue 1663 - Made first-run page use an asynchronous messaging protocol (Closed)
Patch Set: More common approach to wrapping code Created Dec. 17, 2014, 1:12 p.m.
Use n/p to move between diff chunks; N/P to move between comments.
Jump to:
View side-by-side diff with in-line comments
Download patch
« no previous file with comments | « no previous file | ext/content.js » ('j') | no next file with comments »
Expand Comments ('e') | Collapse Comments ('c') | Show Comments Hide Comments ('s')
Index: README.md
===================================================================
new file mode 100644
--- /dev/null
+++ b/README.md
@@ -0,0 +1,56 @@
+Shared Adblock Plus UI code
+===========================
+
+The user interface elements defined in this repository will be used by various
+Adblock Plus products like Adblock Plus for Firefox. Their functionality can be
+tested within this repository, even though they might not work exactly the same
+as they will do in the final product.
+
+Directory structure
+-------------------
+
+* Top-level files: HTML pages and scripts meant to be imported into the
+ respective products.
+* `locale` directory: Localized strings, with one directory per locale. The
+ Firefox format for locale identifiers is used (xx-YY where xx is the language
+ code and YY the optional region code). The localization strings themselves are
+ stored in the JSON format, like the one used by Chrome extensions. There is
+ one JSON file per HTML page, file names of HTML page and JSON file should
+ match.
+* `skin` directory: CSS files and any additional resources (images and fonts)
+ required for these.
+* `ext` directory: Test implementation of the abstraction layer. Is one should
+ *not to be imported*, these files should rather be replaced by
+ product-specific versions providing the same interface.
+
+Testing
+-------
+
+In Firefox and Safari the HTML pages can be opened directly from the file system
+and should be fully functional. Due to security restrictions in Chrome, there
+you need to pass in the `--allow-file-access-from-files` command line flag when
+starting the application. Alternatively, you can run `test_server.py` (requires
+Python 2.7 and [Flask](http://flask.pocoo.org/)) and open the HTML pages under
+URLs like `http://127.0.0.1:5000/firstRun.html`.
+
+Various aspects of the pages can be tested by setting parameters in the URL. The
+only universal parameter is `locale`, e.g. `?locale=es-AR`. This parameter
+overrides browser's locale which will be used by default.
+
+firstRun.html
+-------------
+
+This is the implementation of the Adblock Plus first-run page that will show up
+whenever changes are applied automatically to user's Adblock Plus configuration.
+This will usually happen when the user first installs Adblock Plus (initial
+setup), but it can also happen in the user's settings get lost for some reason.
+
+The behavior of this page is affected by a number of URL parameters:
+
+* `platform`, `platformVersion`, `application`, `applicationVersion`: sets
+ application parameters that are normally determined by Adblock Plus. Using
+ `?platform=safari&platformVersion=5.0` should trigger a warning.
+* `seenDataCorruption`, `filterlistsReinitialized`: setting these parameters to
+ `true` should trigger warnings referring to issues detected by Adblock Plus.
+* `blockedURLs`: a comma-separated list of URLs that should be considered
+ blocked (necessary to test the check for blocked scripts in sharing buttons).
« no previous file with comments | « no previous file | ext/content.js » ('j') | no next file with comments »

Powered by Google App Engine
This is Rietveld