How to Create a Project Homepage and Client Login
A project homepage is a personalised portal for accessing the photoSentinel Control Hub and image galleries.
Most commonly it is used to give clients a branded gallery experience to view images from their installations.
You can customize project homepages in a variety of ways to suit your project, including branding, style, user permissions, and where it is hosted.
You don’t need to have a project homepage for your clients to view their photos; you can just give them a login to Control Hub at setup.photosentinel.com.au.
However, the big advantage of sending clients to a project homepage, rather than setup.photosentinel.com.au, is that you can brand it with own logos, or those of your client.
This is a great way to put you or your client’s brand at the forefront of the gallery experience.
To see an example of a branded project homepage, visit our Demo Homepage.
Project Homepage Options
Two major choices to make when setting up a project homepage include whether you create one homepage or multiple, and where it is hosted.
Single or Multiple Project Homepages
A project homepage can have one or many installations attached to it, so it’s not necessary to create a new homepage for each installation unless you want to.
You can use a project homepage as a “Branded installation management portal” which will add all of your installations, and any new installations will be added to the homepage automatically.
Clients will only be able to view installations that you have given them access to. This is useful if you want to have a single homepage with your own branding that you use with all your clients.
Alternatively, you can create separate project homepages for each of your clients, with their branding being used.
There is no wrong approach; it’s what works best for you and your clients.
You can also set up your image galleries to allow public access (no login required). Scroll down to the Public Installations, Guest Users, and Automatic Login section for more information.
You have three options when choosing where to host your project homepage.
The first hosting option is the .photosentinel.photos domain, which is free to use.
The second option is to use one of our white-label domains.
These are pre-made domains managed maintained by photoSentinel, but give you a project homepage free of any reference to photoSentinel, that you can personalise to your brand.
There are six to choose from:
Charges apply for white-label domains and these can be found in the domain dropdown menu on the Create Homepage page.
Thirdly, you can opt in to our Secure Custom Domain Service, which allows you to use your own existing domain to host photoSentinel project homepages.
To protect your data, and that of everyone who uses photoSentinel, you’ll need to provide us with a wildcard SSL certificate for your custom domain. Setup and ongoing service charges apply; however, after your domain is set-up with a wildcard SSL certificate, you can create unlimited project homepages at that domain at no extra cost.
Once your custom domain is set up, you will see it listed in the dropdown menu as an option along with the others.
How to Create or Edit a Project Homepage
To create a project homepage, follow the step-by-step instructions below.
- Log into Control Hub.
- Select Project Homepages.
- Select Create.
Then, fill in all the relevant fields for your homepage, as detailed in the below sections.
You can edit an existing homepage by following steps 1-2 above, then selecting Setup on an existing homepage, and then selecting the Manage Details and Style button.
Your organisation’s name will be pre-filled here.
Project Homepage Name
Put a descriptive name for your homepage here.
Use as Branded Installation Management Portal
You can use your project homepage as a Branded Installation Management Portal. This will add all of your organisation’s installations to the homepage, and any new ones will be added automatically.
Your staff can manage all your installations from this one homepage, giving you convenient access to all your installations.
Simply turn on the Use as Branded Installation Management Portal toggle.
You can make these portals public by turning on “Allow login bypass for guest users” mentioned below, or read the Public Installations, Guest Users, and Automatic Login section for more information.
Allow login bypass for guest users
Turn on the Allow login bypass for guest users toggle to enable Guest User access to this homepage. Guest Users will not need to provide login credentials to view installations they have access to, bypassing the login screen.
For more information on Guest users, scroll down to the Public Installations, Guest Users, and Automatic Login section.
Project Homepage URL
Select the URL and domain the project homepage will be hosted at. As mentioned above, a homepage can be hosted at photosentinel.photos, one of our white-label domains or a custom domain.
Select Gallery Style
To change the style that your gallery uses, select the Change Gallery Style button.
You will have multiple options to choose from for your gallery style. We recommend selecting the one labelled as “recommended”, as that will always be the latest and most advanced gallery.
For the best gallery experience, we recommend always keeping your web browsers up-to-date with the latest version.
Save & Create Project Homepage
Once you have entered your information into the fields, select Save & Create Project Homepage to save your configuration.
Once you’ve created your homepage, you’ll have access to following additional configuration sections.
Manage Details & Style
Select the Manage Details & Style button to be taken to a modal where you can edit the sections listed above, available when you first created your project homepage.
Select the Manage Branding button to be taken to a modal where you can select branding options for your login page and gallery. The branding options available to you will differ between gallery styles.
Select the Choose file button to upload images or Remove image or Use default image to remove them. Select the Save Changes button when you are done.
For our example below, we will be using the Discovery Gallery style. You can find a find dedicated guide to setting up Discovery Gallery branding here.
- The recommended size for the Login Logo is 600 x 200px
- .jpeg, .png, and .svg are all supported image formats.
- The maximum login logo file size is 50KB.
- The recommended size for the background is 1920 x 1080px
- The recommended image format is jpg. but png. is also supported
- The maximum background file size is 5MB.
- Your login background will be aligned to the top centre of the page. Keep this in mind when uploading your image.
- The background image will be clipped on smaller screens and scaled on larger screens. For this reason, if your client will be commonly viewing the page on a smaller screen (e.g. tablet), you may wish to upload a smaller image that will look best on the smaller screen and scale up to the larger screen (e.g. desktop computer).
Gallery List Background
- The recommended size for the gallery list background is 1920 x 1080px
- The recommended image format is jpg. but png. is also supported
- The maximum background file size is 5MB.
- The recommended size for the banner is 1920 x 100px.
- You can use a logo in the place of the banner; to do this, use an image with a size of 400 x 100px.
- The recommended image format is jpg, or .png for banners with transparency.
- You can insert a hyperlink into the banner, or leave it blank for no hyperlink
- You can set a background color for the Gallery Banner and Logo Background using a valid HTML color string.
- You can set the banner’s alignment to left, right, or centered
- Your logo or banner will be displayed at 100px height regardless of how long the image is. The edges of the banner will be cropped on the side(s) to fit the browser window according to the alignment of the image.
Delete Project Homepage
Select the Delete Project Homepage button to permanently delete your project homepage. You will be asked to confirm before deletion of the homepage.
Select the Manage Installations button to be taken to a modal where you can add or remove installations associated with this homepage.
To add an installation, follow these steps:
- Open the Manage Installations modal by selecting the button.
- Open the Add an installation dropdown menu; locate your installation manually or search for it by name.
- Select Add Installation to Homepage.
To remove an installation, follow these steps:
- Open the Manage Installations modal by selecting the button
- Tick the Remove Selected checkbox next to the installations you wish to remove
- Select the Remove Selected button
How to Set Up a Client Login
Once you’ve created a project homepage, you will then need to create a client login to give your clients access.
There are two steps to creating a user:
- Create the user.
- Associate them with an installation/s.
We’ll look at both of these.
How to Create a New User
To create a new user, navigate to the Users page, and click Add User. Then, fill in all the fields.
Not all fields will be relevant to all users; for example, most clients won’t need to have advanced permissions or receive system warnings.
First name, surname, username
Fill in the user’s name and surname, and create a new username for them.
Select the user’s timezone.
You can randomly generate a password or manually create one for this user. Make sure to copy the username and password to send to your client.
Only tick “Supplier” if you are creating another admin user who you want to be able to configure installations.
The company field is just for your own reference and can be left blank if you wish.
Input the user’s email in case they need to reset their password. This email will also be used to receive system warnings, which generally are not necessary for client users.
The user’s phone number is only required if they are going to receive critical warnings by SMS, and so is generally not needed for client users.
Notification settings only apply to users with permission to receive alerts and so are not generally required for client users.
Once you’ve filled in all the relevant fields, click Save.
You have now created the user, but you have not yet associated them with any installations.
How to Associate a User with an Installation
- Select your installation from the drop-down menu and click on Info.
- In the Users Associated section, select your new user from the drop-down menu.
- Tick the checkboxes for the permissions you would like your user to have. We recommend not checking “Write” or “Receive Alerts” unless the user will be managing the installation and editing its configuration.
- Click Set User Permissions to save these settings. The user should now appear in the list of Users Associated.
Public Installations, Guest Users, and Automatic Login
You can create an image gallery that is public and does not require login credentials to access.
To do this, you must associate a Guest User with it and enable automatic guest login on the homepage via the Allow guest user to access this Project Homepage toggle.
Your organization will have a Guest User by default. Guest users will not be able to login to photosentinel.com.au URLs.
Setting up a Public Installation (a gallery that does not require login)
To grant public access to a gallery:
- Select the installation you would like to have a public gallery.
- Go to Info
- At the bottom of the page, associate the user ‘Guest User’.
- If the installation is attached to a project homepage with “Allow login bypass for guest users” enabled, they will be able to view the gallery via the homepage URL without logging in. Follow the steps below to enable “Allow login bypass for guest users”.
How to enable “Allow login bypass for guest users”
You can turn “Allow login bypass for guest users” on or off by following the steps below:
- Login to Control Hub
- Select the Project Homepages tab.
- Click Setup on the project homepage you would like to use for the public gallery.
- Select Manage Details & Style.
- Ensure that the Allow login bypass for guest users toggle is enabled or turn it off to disable it.
If this article did not resolve your issue, please contact our Support Team.