Install
1) Unzip to the Web Applications folder.
1.1) If you are upgrading, take notice of the upgrading information.
2) Create a Web Application in IIS (if not done yet).
3) Have fun!
Customizing
Most of the customizing functionality is accessible through the browser, by login in to the portal as user "admin" with the password "admin".
Some basic settings are located in the web.config file. I.e. the User Interface language.
To set the User Interface Language, change the value of the "globalization" tag in this file.
Settings of the portal can be changed in the file "Data\PortalData\settings.config". I.e. the title of the website, meta tags...
Most of the layout can be modified in the file Data\Resources\Portal.css. Information to CSS can be found here: http://de.selfhtml.org/css.
The Portal header is customizable by editing the "Data\PortalData\PortalHeader.htm" file. The text "{PlaceHolderLogout}" defines the position of the logout button and the welcome text.
The Portal footer is customizable by editing the "Data\PortalData\PortalFooter.htm" file.
Security
Each User has Roles, minimum the built-in Role "User".
There are 4 built-in Roles:
Admin - Administrator Role. May edit/view everything
User - Signed in User
Everyone - Signed in User or Anonymous User
Anonymous - Not signed in User
Besides these Roles every Administrator may define own Roles ("Editor" for example).
Built-in Roles should never be deleted!!
Data Protection
If you provide data (i.e. content or file downloads) on the portal only for a certain user-group, make sure that
public access is denied for the directory "Data\PortalData" and all the subdirectories. Only the ASP.NET worker process
needs access to this directory. This is necessary to protect the configuration files against direct access over the
internet (i.e. over http://myDomain/Data/PortalData/HtmlEdit/myConfidentialContent.htm).
Backup
All the specific files are in the directory "Data". It sufficient to backup this directory.
Upgrading from the Portal 1.x versions- Copy the file OldPortal\Users.config to NewPortal\Data\PortalData.
- Copy the file OldPortal\Portal.config to NewPortal\Data\PortalData.
- Copy the content files from the OldPortal\Modules\... to the NewPortal\Data\PortalData\... Directory.
I.e. copy OldPortal\Modules\HtmlEdit\*.htm to NewPortal\Data\PortalData\HtmlEdit
or copy OldPortal\Modules\Guestbook\Guestbook_*.config to NewPortal\Data\PortalData\Guestbook
and
copy OldPortal\Modules\Guestbook\Module_*.config to NewPortal\Data\PortalData\Guestbook
...
- Copy the HTML Content (manual) from the OldPortal\PortalHeader.ascx to the NewPortal\Data\PortalData\PortalHeader.htm.
- Copy the HTML Content (manual) from the OldPortal\PortalFooter.ascx to the NewPortal\Data\PortalData\PortalFooter.htm.
- Transmit the settings (manual) from the OldPortal\web.config to newPortal\Data\PortalData\Settings.config.
In future versions most of the settings will be transferred by copy the "Data" directory, to the new installation.
So this will be much easier.