2.1

PrintShop Web Web Integration Guide | 6
External login
The external_login.php file handles the authentication and forwards any parameters included in
the request (POST or GET). If the authentication fails the PSW login page will be shown. Optional
parameters are used to redirect the web browser to a specific PSW web page and to set the skin.
The external_login.php file requires the following attributes in order to authenticate the user:
•
fcUserName, the login name
•
fcPassword, the users password
The following attributes are optional:
•
fcPageID, used to redirect the user to a specific page.
•
fnID, used to send a unique ID to PSW allowing to retrieve the information of a specific template or
order.
•
fcFormID, used to redirect the user to a specific edit or submission page. Example: To show the
user input/database input page of a template you will need to call the preview_init_form form and
specify the unique ID of the template in the fnID parameter. The preview_init_form retrieves all
information of that template in order to show the correct information in the web browser.
•
fcWebDesign, this parameter lets you toggle the skin of the web site. The value of this parameter
should match the Design name which can be setup in the Web Design section of a company.
When no fcPageID or fcFormID is specified the site will be directed to the PSW Welcome page.
The fnID parameter is used in conjunction with the fcPageID or fcFormID parameters. When no
fcWebDesign parameter is stated the system default skin will be used.
Note: For security reasons it is recommended to pass parameters to external_login.php via a
POST request over HTTPS.
Example
Examples are included with your PSW installation and can be found in the webintegration folder of the
PSW web site folder. The sample below is taken from the index.php stored in the basic folder.
<!-- Sample href -->
<a href="external_login.php?fcUserName=administrator&fcPassword=administrator">Login</a>
<!-- Href with redirect -->
<a href="external_login.php?fcUserName=administrator&fcPassword=administrator&
fcPageID=storefront_overview">Login</a>
<!-- Sample form -->
<form method="POST" action="external_login.php">
<input type="hidden" name="fcUserName" value="administrator"/>
<input type="hidden" name="fcPassword" value="administrator"/>
<input type="submit" value="Login"/>
</form>
<!-- Sample form including redirect -->
<form method="POST" action="/external_login.php">
<input type="hidden" name="fcUserName" value="administrator"/>
<input type="hidden" name="fcPassword" value="administrator"/>
<input type="hidden" name="fcPageID" value="storefront_overview"/>
<input type="submit" value="Login and Redirect"/>
</form>