Setting up a site in Vyre Unify

From VYRE

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

Contents

General information

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. robots.txt file - you can specify robots exclusion entries for search engines.
  4. Locale - select the primary locale for your site.
  5. Ignore user locale - if unchecked, it will set the render locale based on currently logged in user's locale. Otherwise if checked (default) user's locale will be ignored and render locale will be set according to other rules.
  6. Allow users to change site locale with query parameter "site_locale" - if set, render locale can be forced with relevant URI parameter.
  7. Show localized item with the current render locale if items with another locale are requested - as explained.
  8. Time Zone - select the primary time zone for your site.
  9. 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.
  10. 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.
  11. 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.

Adding a domain name

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

Image:domainNameMenu.jpg

Enter the new domain name for the site in the input box presented and select a locale if required. If required, enable the basic authentication option and configure it (only available from Unify 4.8). This setting is used by the RESTful services.

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