All xCrud 1.7 features are incorporated into xCrud Pro. It has a Full Bootstrap UI Theme integration<\/p>
With xCrud Pro, you are left dealing with xCrud pages & business logic only.<\/p>
If you have an existing xCrud 1.7 application, you can easily migrate it to the new xCrud Pro.<\/p>
About xCrud Pro<\/h2>
In most cases, solutions require an authentication feature to allow users access the system. xCrud Pro provides a login form that authenticates users against user records in the database. <\/p>
Before usage the following items have to be configured<\/p>
- User is created in the system and given a password.<\/li>
- A role is created in the system.<\/li>
- Menu Tree is created for the role<\/li>
- User is allocated a role<\/li>
- User can now login, select the allocated role and proceed to main page. User will only see the menu items that belong to the selected role<\/li><\/ul>
<\/h2>
User is created in the system and given a password.<\/h2>
xCrud user has a superuser account which is used to configure the rest of the accounts.<\/p>
The superuser account by default has the following credentials. Deletion for this account is disabled.<\/p>
username:<\/strong> admin password:<\/strong> abc123<\/p>
Important<\/strong><\/em><\/p>
Once you have deployed the application to the production environment, it is important to change this password and create a complex password for security purposes.<\/p>
Authentication module provides a login form which is launched on the application access.<\/p>
This allows for users to be authenticated before accessing the system. It is activated by default with the downlodable copy.<\/p>
Upon successful login, user is directed to choose a role and after clicking ‘Proceed’, he is redirected to the main application landing page which for our instance is the dashboard.<\/p>
To add a new user, do the following<\/p>
- login as admin. <\/li><\/ul>
- On the role select window choose the role ‘xCRUD Pro User\/Role Management’<\/strong>.<\/li><\/ul>
![\"\"](\"https:\/\/xcrud.net\/eshop\/wp-content\/uploads\/2020\/11\/RoleSelect-1024x479.png\")
<\/figure>- Navigate to User\/ Role on the left menu<\/li><\/ul>
![\"\"](\"https:\/\/xcrud.net\/eshop\/wp-content\/uploads\/2020\/11\/add_user.png\")
<\/figure>- Click ‘Add User’ and a form to add user will appear.<\/li><\/ul>
- Add user details and save.<\/li><\/ul>
![\"\"](\"https:\/\/xcrud.net\/eshop\/wp-content\/uploads\/2020\/11\/add_user_form-1024x386.png\")
<\/figure>Create role in the system<\/h2>
To create role in the system after login navigate to the menu on the left and click ‘Menu\/Role’. Then click ‘Add’<\/p>
![\"\"](\"https:\/\/xcrud.net\/eshop\/wp-content\/uploads\/2020\/11\/add_role-1024x415.png\")
<\/figure>![\"\"](\"https:\/\/xcrud.net\/eshop\/wp-content\/uploads\/2020\/11\/add_role_form.png\")
<\/figure>After adding and clicking save & edit, a new tab for adding menu items will appear on the window.<\/p>
Menu Tree is created for the role<\/h2>
To add a menu item for a specfic role navigate to menu item Role\/Menu and a list of all roles will appear.<\/p>
- Click ‘Edit’ against the role you wish to add the menu item. <\/li>
- Then click the tab ‘Menu’ and you will see the option to click ‘Add’ for adding a new menu item. <\/li>
- When you click ‘Add’, a form to enter a menu item will appear<\/li><\/ul>
![\"\"](\"https:\/\/xcrud.net\/eshop\/wp-content\/uploads\/2020\/11\/menu_item-1024x569.png\")
<\/figure>Page with Data<\/strong><\/p>
![\"\"](\"https:\/\/xcrud.net\/eshop\/wp-content\/uploads\/2020\/12\/menu_filled_up-1024x509.png\")
<\/figure>Explanation of Fields for Menu Item Form<\/strong><\/p>
Role<\/td> Not editable<\/td><\/tr> Menu Name<\/td> The menu name that appears on the menu
<\/td><\/tr>Parent Menu<\/td> Select the parent menu. If a parent menu is not included, the menu that is being added will be the parent meaning it will not have a child. If you select a parent, the new menu will become a child of the parent menu selected.<\/td><\/tr> Order Sequence<\/td> This a number that you key in to specify the order in which the menu appears. A higher number means the menu will apear lower than a number which lower than what was entered.<\/td><\/tr> icon<\/td> The icon that is appended infront of the menu name. This option is not active for xCrud version 1.0. It will be an update feature within a short time.<\/td><\/tr> Description<\/td> A simple description of the menu item for documentation purposes.<\/td><\/tr> isActive<\/td> This field is used to activate or deactivate the menu item. if ‘Yes’ it means the menu is visible. if ‘No’ the menu is not visible.<\/td><\/tr> Page Link<\/td> This is the php page that is called when the menu item is clicked. All php pages are stored in the ‘pages’ direcrtory in the root folder for xCrud Pro.<\/td><\/tr> <\/td> <\/td><\/tr> <\/td> <\/td><\/tr> <\/td> <\/td><\/tr><\/tbody><\/table><\/figure> Once a menu item is added and saved successfully, it is able to be viewed by a user with the given role.<\/p>
User is allocated a role<\/h2>
To allocate user a given role, login and navigate to the menu and click on ‘User\/Staff’<\/p>
A list of all users will appear. <\/p>
- Select edit on the user you wish to allocate the role. <\/li>
- On the form that launches, you will see a ‘user role’ tab. Click on it<\/li>
- Then Click ‘Add’ user role. <\/li>
- A form to add the role will appear. The form has a list of all available roles<\/li>
- Save and return.<\/li><\/ul>
![\"\"](\"https:\/\/xcrud.net\/eshop\/wp-content\/uploads\/2020\/11\/user_role_form-1024x472.png\")
<\/figure><\/p>
User can now login, select the allocated role and proceed to main page. User will only see the menu items that belong to the selected role<\/h2>
If you login you with a user, you are able to select only the role provided to the user. You can also view only the menu that is allocated to that role.<\/p>
Form & Page Configuration<\/h2>
xCrud Pro has a simple directory structure. The most important directories include<\/p>
<\/p>
\/Page<\/strong>s<\/td> This directory contains all xCrud pages that can be referenced by the menu<\/td><\/tr> \/lib<\/strong><\/td> This directory contains the xCrud 1.7 library and uploads folder where uploaded pictures are stored<\/td><\/tr> \/css<\/strong><\/td> The theme css is located in this folder and can be altered to suit your need.<\/td><\/tr> <\/td> <\/td><\/tr> <\/td> <\/td><\/tr><\/tbody><\/table><\/figure> Summary<\/h2>
All demo pages\/forms that are currently in xCrud 1.7 have been loaded in the pages\/<\/strong> directory of xCrud Pro. <\/p>
All forms apart from login and role select are basically xCrud configurable pages.<\/p>
Migration of existing Project<\/h2>
To migrate existing application ensure you do the following.<\/p>
- Move all you xCrud pages to the ‘pages\/’<\/strong> driectory<\/li>
- Configure the menu items and point to your xCrud pages<\/li>
- Configure users and roles and you are good to go.<\/li><\/ul>","protected":false},"excerpt":{"rendered":"
The main goal of xCrud Pro 1.0 is to reduce the development time while providing a cutting edge robust solution. xCrud Pro 1.0 utilizes xCrud 1.7 library in its framework. xCrud Pro has the following modules Authentication Module User\/Role Configuration Module Role\/Menu Configuration Module xCrud 1.7 All xCrud 1.7 features are incorporated into xCrud Pro. … <\/p>\n
- Move all you xCrud pages to the ‘pages\/’<\/strong> driectory<\/li>
- Add user details and save.<\/li><\/ul>
- Click ‘Add User’ and a form to add user will appear.<\/li><\/ul>
- Navigate to User\/ Role on the left menu<\/li><\/ul>
- On the role select window choose the role ‘xCRUD Pro User\/Role Management’<\/strong>.<\/li><\/ul>
- login as admin. <\/li><\/ul>