User Space

From Wiki openElement
Jump to: navigation, search

Contents

Description

The "User Space" group allows users to easily integrate a user management system on a website.
To do this, simply drag-and-drop the Element Packs of this group on the page and follow the included directions to configure them.
Note: Each Pack is available in English and French.

The Basics

The first 4 Packs in the group should be placed on 4 "special" pages, one for each Pack. The "admin" page must be created manually.
The other required pages are automatically generated by clicking on the button "Create Pages Now" in the configuration wizard.
The administration page initializes the database (locally if in preview mode, and online if the website is published) when it is opened in a web browser.

The Packs

The 4 first "Packs" each correspond to a "special page":

10 – For the Admin page: Accessible to the website administrator, this page is designed to manage the site's users. When it is first opened in a web browser, the page generates the database and the "Admin" user account.
For each version of a website (local preview, hosted online, AMP), this page must be opened at least once in a web browser to initialize the database.
20 - For the Login page: User account login page.
30 - For the Signup page: New user account signup page.
40 - For the Edit Account page: This page allows administrators to edit user account information, such as user permissions (restrict access to administrator only) and personal information, as well as the possibility to delete user accounts.

The 2 "General" Packs for any page of the website:

50 - Protect a page: Automatically redirects to the "Login" page if the user isn't already/currently logged in.
60 - "Display User" Element: A Text element that displays the username of the user that is currently logged in, as well as a login/logout link.

Directions

Admin Page: Pack "10 – For the Admin page"

Create a new page called, for example, "admin."
Users are recommended to increase the height of the page so that all of the Pack's contents will fit on it.
Drag-and-drop the pack "10 – For the Admin page" on this new page. openElement will then ask to change the page to PHP; confirm the change.
The configuration wizard will pop up.

Steps of the Configuration Wizard

Step 1:
The "Default Admin Password" setting must be filled out.
It is recommended to use a combination of uppercase and lowercase letters, numbers and/or special characters like %, $, and +.

Step 2:
Fill out the fields by entering the link corresponding to the pages "Edit Account" and "Login".
If the pages do not exist, click on the "Create Pages Now" button to generate them automatically.
By default, these pages will be named "log-edit-profile-v1" and "login-v1".

Continue by clicking on the " > " button and "OK" before making any other changes.
These settings can be reconfigured by editing the Pack (see below, near the end).
Confirm the page save (or save it manually [Ctrl+S]) and then, preview the page in a web browser (F12).
Previewing serves the purpose of initializing the database on the local preview server.

Login Page: Pack "20 - For the Login page"

Rename the page "login-v1" if necessary (for example: login).
Open the page and drag-and-drop Pack "20 - For the Login page".

Steps of the Configuration Wizard

Step 1:
Double-check the link to the Home page. If it's not correct, change it accordingly.
Also check the link to the "Signup" page. If it doesn't exist, click on "Create Pages Now" to generate it (Default page name: log-new-account-v1).

Step 2:
Fill out the field "Sender's Email Address". Please enter a valid email address (example: noreply@mywebsite.com). You may also leave this field empty, but this is not recommended because openElement will use the same email address as the recipient, which may trigger certain SPAM filters.

Follow the rest of the steps without changing any more settings and save the page.

Signup Page: Pack "30 - For the Signup page"

Rename the page "log-register-v1" if necessary (example: signup).
Open the page and drag-and-drop Pack "30 - For the Signup page".

Steps of the Configuration Wizard

Step 1:
Click on the button to the right of the "Link to Admin Page" setting. Then choose admin page, which was created earlier.
The field "Link to the Login Page" must already be filled out. If it is not, please enter it accordingly.

Step 2:
Please ensure that the field "Sender Email Address" corresponds to the setting in Pack "20 - for the Login page".

Follow each step of the configuration. Continue until the last step of the configuration, which contains settings to protect against spam. By default, users can confirm the creation of an account by following a link they receive by email. To change this, uncheck that option and check the option for confirmation by administrator instead. Note: It is also possible to skip confirmation of new users, but this increases the chances of spam. If you find yourself being spammed, this Pack can be reconfigured with email or admin confirmation enabled. Then, simply republish the website (there is no need to create this page again). Save the page.

Edit Account Page: Pack "40 - For the Edit Account page"

Rename the page "log-edit-profile-v1" if necessary (example "profile"). Open this page and drag-and-drop Pack "40 - For the Edit Account page". The "link" settings are filled out automatically (if they are not, please enter them using the buttons on the right). Continue without changing any other settings. Save the page.


Pages "50 - Protect a page" and "60 - 'Display User' Element"

The two remaining Packs, "50 - Protect a page" and "60 - 'Display User' Element" concern other pages of the website.

Modifying Elements and Data

Users can change the placement, style, and text of these elements the same way that they're used to in openElement. Elements with text in parentheses ( ) display dynamic content. There is no need to edit this text. The database: 2 database tables are being used, oe_logv1_users and oe_logv1_userinfo. The column "rights" corresponds to access rights/permissions: "-1" - blocked, "0" - awaiting validation (confirmation), "1" - standard access, "5" - advanced access, "10" - administrator account (only the "Admin" account can see this value). See also the General Instructions.

General Notes

1) Local Preview:
Email sending is replaced by a "simulation": if emails have been sent by the system, the blue banner will appear at the top of the pages (only in local preview); double-click the banner to open the latest messages. The SQLite database is located in the file WEFiles/Server/DB/Local_previs_DB/oedb.db. The management tool is available by double-clicking on the grey banner at the top of the page.

2) Configure Database Connection:
This must be done before the website is published or exported. In the Site Explorer on the left of the screen, double-click on Database - Default.
By default, the engine (type) of the databases is SQLite. It has the advantage of not requiring configuration, it is easy to use, and the database can be found in a single file (by default: WEFiles/Server/DB/SQLite_DB/oedb.db for a published website). It is also easy to copy and back-up. However, there may be some slowdown if the database is large, and this engine may not be available on on all web hosts. To manually edit the SQLite database, use tools such as PHPLiteAdmin. Never leave the database file in a non-protected location (such as the root of the website). The MySQL engine is more powerful, more secure, and is available on most web servers, along with management tools like PHPMyAdmin for editing databases manually. The connection parameters will be provided by your web host. The "Port" and "Database Name" are sometimes optional. One of the major inconveniences of this engine, though, is the difficulty associated in copying and transferring the database.

3) Publish the website online or on AMP (easyPHP etc.):
After an initial publishing, depending on which Packs are used, certain pages must be open first to initialize the database. Follow the instructions.

4) Modifying "Packs" and Their Elements:
To reconfigure a Pack on a page, select the element that represents it in the Hidden Elements Bar right above the Editing Pane when the page in question is open, and click on Configure. To select all associated elements, click on "Select the Elements." In the Configuration Wizard, a green icon on the left of a setting will indicate that this setting is "shared" - its value is the same across multiple Packs.
Most elements added by the "Pack" can be moved or made inivisble (Using the "Visible" property, "Filter by Language," or in Styles). The styles and text can also be changed. Certain elements can also be deleted, but it is safer to just make them invisible. To delete the entirety of a "Pack," select the element that represents it in the Hidden Elements Bar (located above the Editing Pane) and select "Delete."

Personal tools
Namespaces

Variants
Views
Actions
openElement
Community
Toolbox