.---------------------------------------------------------------------------.
|                             Documentation                                 |
'---------------------------------------------------------------------------'

 Redirector is a Firefox extension that redirects any website's content page
 to archive.is. This extension exists because articles on some sites are
 behind a paywall or an anti-adblocker script.

 Once redirected to archive.is, the article will likely appear if it's a
 popular site. If it hasn't already been archived, you can archive the article
 yourself. In most cases, archiving will make the article contents accessible.

 Note: this extension does not do anything that you cannot already manually
 do yourself. It simply automates some basic steps.

 The following sites get redirected to archive.is:

 The Washington Post     : washingtonpost.com
 The New York Times      : nytimes.com
 The Wall Street Journal : wsj.com
 Bloomberg ............. : bloomberg.com
 The Hill .............. : thehill.com
 Vox  .................. : vox.com
 Wired ................. : wired.com

 I'll keep updating this extension with new sites as I come across them.

 Optionally, you can add sites yourself. To add new sites, just follow the
 logic of the (1) background.js and (2) manifest.json files

.---------------------------------------------------------------------------.
|                           Steps to install                                |
'---------------------------------------------------------------------------'

 1. Create XPI file

    a. download from https://640kb.neocities.org/apps/apps
       - manifest.json (text file)
       - background.js (text file)
         [the two files are easy to follow. They are safe)

    b. compress both files as a single ZIP file (redirector.zip)

    c. rename to redirector.xpi

-----------------------------------------------------------------------------

 2. Turn off requirement for signed extensions

    You must feel comfortable doing this.
    FYI: extensions don't auto-install themselves.

    Note: Firefox always warns if you install an unsigned extension.
          You are not giving up control over what gets installed.

    a. about:config
    b. search: xpinstall.signatures.required
    c. set it to FALSE

-----------------------------------------------------------------------------

 3. Install to Firefox
    a. open new tab
    b. drag XPI to open window


.---------------------------------------------------------------------------.
|                        Tip : Temporary Install                            |
'---------------------------------------------------------------------------'

 If you just want to test the extension without permanently installing it
 and/or creating the zip/xpi file.

 1. download
    - background.js
    - manifest.json
 2. open Firefox
 3. in the address bar, type: about:debugging
 4. click "This Firefox" in the left sidebar
 5. click "Load Temporary Add-on"
 5. select the manifest.json file only

 Firefox will temporarily install the extension from the directory where
 you saved the file. The extension will unload when Firefox closes

.---------------------------------------------------------------------------.
|                            How This Works Now                             |
'---------------------------------------------------------------------------'

 When main domain = https://www.washingtonpost.com

     Path is "/" = no redirect

 Section front (https://www.washingtonpost.com/politics/):

     Path has only one segment ("politics") = no redirect

 Article (https://www.washingtonpost.com/politics/2024/article-name/):

     Path has multiple segments = redirect to archive.is

 Already archived URL:

     Checks for archive.is in hostname = no redirect (prevents loops)

 Edge Cases Handled

     Works with both www.washingtonpost.com and washingtonpost.com

     Handles HTTP and HTTPS


.---------------------------------------------------------------------------.
|                                 Changelog                                 |
'---------------------------------------------------------------------------'

 04 june 2025 : v 1.0 : 4 sites (wired, nytimes, wsj, washingtonpost)
 05 june 2025 : v 1.1 : added vox.com
 18 june 2025 : v 1.2 : added bloomberg.com, thehill.com
 22 june 2025 : v 1.3 : updated the documentation


------------------------------------ eof ------------------------------------