1. Initial Setup

1.1. Once the ClickHome.MyHome plugin is activated, a new admin section called “MyHome” should appear on the left menu.

1.2. This plugin requires a Login page (i.e. a page containing a Login shortcode). Create it as a regular page:

Enter a title for the page (e.g. “Login”) and the shortcode “[MyHome.Login]” as the content. Click the “Publish” button.

Don’t try to view this page yet – you must configure the plugin first.

1.3. Now, go to the ClickHome.MyHome plugin settings page:

The following settings are available:

  • API Endpoints Base URL: you must enter the API URL as your External facing IIS location. Often this is the MMService Location minus the ".../mmservices" portion.

  • Login Page: you must choose a page containing a Login shortcode. If you created the Login page as stated in the previous step, clicking “Autodetect” will choose it for you.

  • Logoff Option (optional): it is advised to provide logged in clients an option to log off from the site. If you already have a WordPress menu set up in your site, you can add a Logoff option to it by choosing the menu location and providing an option name. ClickHome.MyHome plugin will append this option when a client is logged in.

  • Main Page (optional): if a Login page is easily reachable by guests (for example, by following links or menu options on the page), a login form will be displayed with no information about where to redirect the user upon successful login. In that case, it is wise to have a main page set up, so that clients get redirected to it after logging in. You can leave this option blank and change it after you have created some pages with MyHome shortcodes other than the Login shortcode.

  • Log Enabled: you can enable logging by checking this option. Logging will allow ClickHome to assist you in resolving any problems you may have.

  • Logging Level (if logging is enabled): you can choose between “Error” and “Info” severity levels. “Error” is suitable for most purposes. The plugin will log any error triggered by the plugin when displaying shortcodes. Choose “Info” to log some more information (e.g. when a client is logged in). When logging is enabled, a third tab –Log– is shown on the right.

Once you have set up the plugin, click the “Save Changes” button.