Introduction
This article will help you if you would like to have Client Portal set up on your own domain. This means, that there will be no perfectgym.com or perfectgym.pl suffix in the domain name. This can be done, however, please be aware that we simply cannot link your domain to our servers, mainly due to a problem with managing SSL certificates.
There are basically two solutions available:
- Reverse proxy
- Embedded Client Portal
This article will explain how these two solutions work and how they can be applied.
Before you start
Note, that you would need to engage your IT department, or a third party company to set up the reverse proxy according to the instruction presented below, or embed Client Portal into your existing site. Be aware that for a web developer, or IT administrator, the procedure described below, is pretty straightforward, so this instruction's intention is to show possible solutions and cover this subject very roughly.
Feature description
Reversed proxy
A reverse proxy is a web server, that is redirecting the incoming traffic to other server, and giving back responses.
It serves as a gateway to another site, in this case, to the Client Portal.
Let's say we have a company named xyz. Their CP2 address would be https://xyz.perfectgym.pl/ClientPortal2.
We want to have CP2 to be available on address https://xyz.com/client-portal.
How to install the proxy?
- You need to have the domain, lets assume its xyz.com.
- You also need a kind of private server, or hosting. It can be really anything, Apache, nginx, Azure, standalone IIS. Every popular server supports reverse proxying. If you have a website, you already have such a hosting and are able to use it for this purpose.
- You need to configure your server to set up a reverse proxy, that is bound to the address you want to use (https://xyz.com/client-portal in this case), and rewrite traffic to Client Portal address (https://xyz.perfectgym.pl/ClientPortal2 in this case).
Unfortunately, we cannot cover any detailed instruction on how to do it, because it's very technical, and our expertise is restricted to IIS servers.
- A reverse proxy is required to run on server secured with HTTPS protocol.
There is a security check inside Client Portal, so if there is no HTTPS, it simply won't work and would redirect back to PerfectGym domain.
- Also, remember to set rewriting domain in cookies, or many features may not work properly:
- After having configured the reverse proxy, you need to set a setting ClientPortal.ReverseProxyUrl to a proper value.
- It has to be set to the same exact URL, that your reverse proxy is configured on. In our example, it would be https://xyz.com/client-portal. Without that setting, a member would be redirected back to PerfectGym domain, so effectively reverse proxy would not work.
Note, that setting up this setting to wrong value would make Client Portal not working at all! Please test it afterward!
Embedded Client Portal
If you would rather embed Client Portal into your existing site, such possibility exist as well. The example of this solution working would be displaying a class schedule on your WordPress page, or so.
- The detailed information on how to do it can be found here.
This solution requires modifying your website. We advise you utilize your IT department, or contract a third-party company to set it up.
To embed the calendar on your website, contact the Perfect Gym Support Team and ask to turn on the following Setting ClientPortal.AllowedDomains for your database.
FAQ
Is it possible to embed a time table already with a filter by class type?
Yes. Use force URL argument and use URL with this already selected.