Custom Registration URL Technical Details

When directed to your custom registration URL, the user will be passed with three additional variables:

btx_i = issue id
btx_pub_id = publisher id
btx_m = publication id

Your URL should have two fields for login: one for login name and another for password. This form should submit to the desired domain + "/publication/logincheck.php" (e.g., http://www.mydigitalpublication.com/publication/logincheck.php).

The fields should be named reader_login for the entered login, reader_password for the entered password, pub_id for the Publisher ID, and either "i" for the Issue ID (if a specific issue ID is requested) or "l" set to 1 and "m" set to the desired Publication ID (if the latest issue of a publication is desired).

There are two additional URL variables that can be set (usually when there are preview pages associated to an edition and the reader tries to access either a page or article outside of the preview range):

btx_a = article id
btx_p = internal page number

The article id and internal page number variables can be passed to the desired domain + "/publication/logincheck.php" as "a" and "p", respecteively, to return the reader to the content that they had requested immediately before being gated.

1. Here is an example of an HTML form for a specific issue ID:

<form action="http://www.mydigitalpublication.com/publication/logincheck.php" method="post">
  Username: <input type="text" name="reader_login" />
  Password: <input type="password" name="reader_password" />
  <input type="hidden" name="pub_id" value="9999" />
  <input type="hidden" name="i" value="99999" />
  <input type="submit" value="Submit" />
</form> 

2. Here is an example of an HTML form for the latest issue for a specific publication ID:

<form action="http://www.mydigitalpublication.com/publication/logincheck.php" method="post">
  Username: <input type="text" name="reader_login" />
  Password: <input type="password" name="reader_password" />
  <input type="hidden" name="pub_id" value="9999" />
  <input type="hidden" name="m" value="9999" />
  <input type="hidden" name="l" value="1" />
  <input type="submit" value="Submit" />
</form> 

3. You can also pass the reader to a custom authentication failure page by specifying the parameter "err" whose value should be set to the full URL of the custom page:

 <input type="hidden" name="err" value="http://www.somedomain.com/path_to_error_page.html" />

Note: SSL security for authentication is available using the method below.

An alternate method is available if you require a secure method for login that does not transmit username and password except using an SSL-encrypted connection. The form structure is exactly the same as that described above, with two exceptions:

 

1. The "action" must be set to "https://www.mydigitalpublication.com/publication/logincheck.php" (note the "s" in "https") regardless of the desired target domain.

 

2. Another hidden field for the target domain (targ_dom) must be set:

 

<input type="hidden" name="targ_dom" value="somedomain.com"/>