Setting up a site in Vyre Unify

From VYRE

Jump to: navigation, search
List of sites
Create a Site

To set up a site, first click on publishing at the bottom of the LH navigation screen. This section of Unify is used to make and maintain the pages of your website. Then click on "Sites" in the left hand top navigation bar, and you will be presented with the screen listing all the sites residing on the instance you are developing on.

Please note that if there are no sites on the instance you are working on, then no sites will appear on the right side as they do in the above screen. Also the navigation on the left side can be configured to either list all the websites under "Sites" when expanded or to have a dropdown menu with all the sites and letting user to select the site that will appear under "Sites" (As it can be seen in Figure 1 above that there is a dropdown above "Publishing" and "Unify Tutorial" is selected, which only is appearing under "Sites" section).

  1. Title - enter the title of your site (e.g. Tutorial site), note that Unify takes advantage of dynamic variables in page titles, so you can dynamically assign the title of the site to the title of a page [please click here to see the full list of all variable available.
  2. Description - enter a simple description of your site (e.g. An introduction to using VYRE Unify). Again this field is available as a dynamic variable that can be used when creating pages
  3. Locale - select the primary locale for your site.
  4. Time Zone - select the primary time zone for your site.
  5. Allow users to store login cookies for this site - when this box is checked this will allow users to store a login cookie that will remember the user the next time they log in.
  6. Maximum cookie age in days (only appears when "Allow users to store login cookies for the site" is checked) - this sets the length of time the cookie is stored for.
  7. Session timeout - Set the session length required for the deployed site. Please note that the "default" means that timeout will be set to 30 minutes.
  8. NTLM HTTP Authentication - check this box if you require Microsoft's NTLM HTTP Authentication. NTLM employs a challenge-response mechanism for authentication, in which clients are able to prove their identities without sending a password to the server. It consists of three messages, commonly referred to as Type 1 (negotiation), Type 2 (challenge) and Type 3 (authentication). It works as follows:
    1. The client sends a Type 1 message to the server. This primarily contains a list of features supported by the client and requested of the server.
    2. The server responds with a Type 2 message. This contains a list of features supported and agreed upon by the server. Most importantly, however, it contains a challenge generated by the server.
    3. The client replies to the challenge with a Type 3 message. This contains several pieces of information about the client, including the domain and username of the client user. It also contains one or more responses to the Type 2 challenge.

The responses in the Type 3 message are the most critical piece, as they prove to the server that the client user has knowledge of the account password. Click here to read more on NTLM HTTP Authentication.

Contents

Adding a domain name

To add a domain name to a site hover over Edit in the site context menu and select 'Add Domain'.

Image:domainNameMenu.jpg

Enter the new domain name for the site in the input box presented and select a locale if required.

Image:domainNameEdit.jpg

You will see the new domain added to the list of current site domains under the heading 'Domain names'. To delete or edit a domain name click the appropriate icon in this 'Domain names' list.

Image:domainNameList.jpg

Settings

There are a number of configuration options available at a site level. These can be viewed and modified by clicking on the sites icon in the publishing module (the site icon is a small globe at the top of the site tree).

Setting up a virtual path

To create a vertual path to a page hover over Actions in the site context menu and select 'Add Virtual Path'.

Image:virtualPathMenu.jpg

Type the path of the page that you wish to create a virtual path for or choose it from the site tree and type the virtual path in the field marked 'Virtual path'. If the page is an item display page you can choose an item to display by entering the item ID into the 'Displayed item' field.

Image:virtualPathEdit.jpg

You will see the new virtual path added to the list of virtual paths under the heading 'Virtual paths'. To delete or edit a virtual path click the appropriate icon in this 'Domain names' list.

Image:virtualPathList.jpg

Setting a Start page

To set the start (landing) page for a site hover over the Settings button in the context menu and choose 'Set Start Page'

Image:SetStartPage.JPG

Then choose the page you want to set from the site tree.

Image:SiteTree.JPG.

When a user navigates to the sites domain name, this is the first page they will see.

Setting a login page

If no login page has been selected for a site the following warning will appear just underneath the context menu. Image:LoginPageWarning.JPG

To set the login page for a site hover over the Settings button in the context menu and choose 'Set Login Page'

Image:SetLoginPage.JPG

Then choose the page you want to set from the site tree

Image:SiteTree.JPG.

If a user tries to navigate to a page that is access controlled and they are not logged into the site, then they will be redirected to the login page. A login page will typically contain an instance of a Login Portlet.

Setting an unauthorised page

If no unauthorised page has been selected for a site the following warning will appear just underneath the context menu. Image:Unauthorised PageWarning.JPG

To set the login page for a site hover over the Settings button in the context menu and choose 'Set Login Page'

Image:SetUnauthorisedPage.JPG

Then choose the page you want to set from the site tree

Image:SiteTree.JPG.

If a user tries to navigate to a page that is access controlled and they are logged into the site but have insufficient permissions, then they will be redirected to the unauthorised page.

To set the 404 page for a site hover over the Settings button in the context menu and choose 'Set 404 Page' - Then choose the page you want to set from the site tree.

Setting a 404 page

If no 404 page has been selected for a site the following warning will appear just underneath the context menu. Image:404PageWarning.JPG

To set the 404 page for a site hover over the Settings button in the context menu and choose 'Set 404 Page'

Image:Set404Page.JPG

Then choose the page you want to set from the site tree

Image:SiteTree.JPG.

If attempting to navigate to a page results in a 404 error (i.e. a page with the specified URL does not exist) the user will be redirected to this page.

Setting an Error page

If no error page has been selected for a site the following warning will appear just underneath the context menu. Image:ErrorPageWarning.JPG

To set the error page for a site hover over the Settings button in the context menu and choose 'Set Error Page'

Image:SetErrorPage.JPG

Then choose the page you want to set from the site tree

Image:SiteTree.JPG.

If attempting to navigate to a page results in an error the user will be redirected to this page

Personal tools