Control Panel

The Control Panel Dashboard gives you an overview of commonly performed tasks along with news about Deki, Version, Video Tutorials and more.

1. Return to Deki will take you back to the homepage of your MindTouch Deki install
2. Get Supported links to the MindTouch Deki Enterprise Activation Screen to activate your Enterprise License
3. FAQ links to the MindTouch Deki General Frequently Asked Questions page
4. The Question Mark button links to the Control Panel User Manual, which you are reading right now
5. Videos are helpful overviews of MindTouch Deki to help you get a jumpstart on using the product
6. My Quick Links are the commonly performed task links so that you can save time. To customize your Quick Links, click the "Edit My Quick Links..."
7. Technical News from MindTouch Deki displays notices about patches, releases, and other pertinent notifications
8. MindTouch Deki Product Activation gives an overview of how to activate your MindTouch Deki and how to get an Enterprise License if you don't have one
9. Your MindTouch Deki section tells you what version of MindTouch Deki you are running along with other helpful resources and Credits
10. If you'd like to revert back to the old control panel click this link and it will be enabled

The Users and Groups section allow you to manage users, groups, roles, and authentication integration

1. Add a username for the user. Note: This will be a visible username to all users on the wiki so it is best not to use private information like email
2. Add the email of the new user so that they can receive system notifications including their new login credentials
3. If you don't type, and verify, a password for the user then the system will automatically generate one for them and send it to them in an email
4. Specify the role that you want this user to have - See Role Management for more details on what roles are available
5. Select the service that the user belongs to. By default the service will be Local. If you are adding users through an External Authentication service, you'll need to add them through the External Authentication interface as opposed to MindTouch Deki's interface
6. Add the user to a group that has been setup already. Note: You can add users to groups after they have been created through the group management interface
7. Click add user, the user will then be email their login credentials and they will be listed in the User Management list below this form. 9) Click on this to Add Multiple Users at once

    

To add multiple users at once do the following:

1. Enter username and email address separated by commas with one entry per line, as seen above
2. Select the Role that you want applied to all of the Users. Note: User roles can be changed after being added
3. Select the Authentication method, default is Local
4. If you specify an External Authentication Provider for the Service then you may be required to enter credentials in order for MindTouch Deki to access it
5. Add all of the users to a group or many groups
6. Once you have everything configured then click the Add Multiple Users button and they will automatically be sent emails with their login credentials

If you'd like to view a list of all of the users click the View All link, otherwise you can enter a name, email, or keyword into the search field and find one user or set of users depending on the search. If you click View All then you will see a screen that looks like the following:

If you didn't add users to a group when you created them you can add them to one now. Select the users that you want to addd to a group and then click Add to Groups. Then you will see the following where you can select the Group(s) that you want to add the user(s) to and then click Add to Groups.

To change the roles of user(s), select the user(s) and then click the Change roles link. This will then show the following where you can select the new role that you want to apply to the selected users. One you have selected the role click the Change roles button and the roles will be applied to the user(s)

The Group management page allows you to Create, Edit, and Delete Groups. To Add a Group click the Add Groups link.

1. Add the name of the Groups you want to add, seperated by commas
2. Select the Role that you want to associate with the groups
3. Select the Authentication Service that this group is associated with
4. Click Add Groups to add the groups to MindTouch Deki

To Delete a group, select the group(s) you want to remove and then click the Delete link. This will then bring up the following confirmation screen which you will select Delete in order to remove the group(s) from the system.

Need to add the Edit Group page

1. LOGIN
   The Login Attribute stipulates if a user is able to login when they reach the site. This, with READ, are the most fundamental of roles.


2. BROWSE
   The BROWSE Attribute stipulates if a user is able to browse the hierarchy or discover content within the wiki via search.


3. READ
   The READ Attribute stipulates if a user is able to view a page, comments, or attachments.


4. SUBSCRIBE
   The Subscribe Attribute stipulates if a user is able to subscribe to the RSS feeds of the system which will show pages changes


5. UPDATE
   The UPDATE Attribute stipulates if a user is able to make changes to a page or attach files in the wiki


6. CREATE
   The CREATE Attribute stipulates if a user is able to create a New Page within the wiki


7. DELETE
   The DELETE Attribute stipulates if a user is able to Delete an existing page within the wiki


8. CHANGE PERMISSIONS
   The CHANGE PERMISSIONS Attribute stipulates if a user is able to Change or Add Permissions of a page


9. CONTROL PANEL
   The CONTROL PANEL Attribute stipulates if a user has access to the Control Panel - This should only be accessible to the Admins of the wiki, use sparingly


10. UNSAFE CONTENT
    The UNSAFE CONTENT Attribute stipulates if a user is able to add unsafe scripts or HTML into a wiki page without it being stripped out. If you want the users to be able to add some
    Unsafe Content then take a look at adding an extension for it.


11. ADMIN
    The ADMIN Attribute stipulates if a user has Admin privledges which overrides all other permissions and restrictions. Use sparingly.


12. To add a new Role, give the role a name, click on the permissions you want to associate with the role and then click Add Role
    Note: You cannot delete a role through the Role Management interface

Any editing, creating, and management of External Authentication Services are done in this section

To add an external authentication service to MindTouch Deki click the Add Authentication Service

If you want to Restart or Stop an Authentication service, select the service and then click on the link for the action you want to perform. If you stop the service then in the Status column it will say Stopped.

To Delete an Authentication Service, click the service and then Click Delete. To finalize the Delete then click Delete Authentication Providers as seen below. If you want to cancel the Delete then you can click Cancel.

If you want to edit an External Authentication click the Edit link next to the External Auth Service. This will open up the following screen where you can edit the settings for the authetication service. Once you are done with the configuration click the Edit Authentication Service button.

You can change which authentication is set as Default so that when your users get to the login page it will be the default one checked. With a fresh install, the Local Authentication service is default. To change the default service click on the grey dot next to the service that you want to make default. This will change into a green check denoting that it is now the Default authentication service.

Customize your sites look and feel along with adding custom scripts and CSS overrides.

To upload your own logo Click the Browse button and then click the Upload Logo button. If you want to use the MindTouch logo for your site click the Use Default Logo.

To add a custom skin to MindTouch Deki:

1. Use the Navigation pane to find a Skin that will fit your site
2. Check it out in the Preview window and confirm it is what you are looking for
3. Click the Apply Skin button

    

   The Skin will then be applied to your MindTouch Deki site.

1. The Site Name is the name that will appear at the top of your MindTouch Deki hierarchy and in the Header of the browser
2. Set the Site Language allows you to change the localization of MindTouch Deki. MindTouch Deki currently supports over 15 Languages
3. To enable Multi Lingual support in MindTouch Deki add the appropriate Language acronyms here, see the User Manual for details on configuration and use of Multi Lingual
4. Once changes have been made click the Save changes button

Custom CSS allows you to override styles being used by your current MindTouch Deki skin. Custom CSS is skin and style specific and therefore only applies to the skin style that you currently have set. The text areas correspond with the screenshot across from it. The first text area has control over the CSS elements for the WYSIWYG editor area. The Skin Template has control over the Site Skin. Once you have added custom changes in the text area then you can click Save Changes and they will be applied to your site. This area is intended for people with knowledge in CSS. It is not recommended to test settings on a production site.

Custom HTML gives you control over predefined areas of MindTouch Deki to add things like Analytic Scripts, Ads, Custom buttons, headers, widgets, etc. To add custom HTML, paste it into the text area that corresponds with the area you want it placed. Once you have it in the right text area then click Save Changes and the customizations will be applied to your site.

The Editor page allows you to add custom configuration to your FCK Editor to enable new buttons/features. Click on the FCKeditor's configuration to learn more about custom additions

Bans allow you to block users from logging into your MindTouch Deki install by banning their username or the IP address that they are accessing your MindTouch Deki from.

To Add a Ban do the following:

1. Select the ban type from the dropdown. You can ban a user by IP or Username
2. Once you have selected what type of ban to add then add the username or IP address. The username will be case sensitive and the IP address will be formatted like this: 192.168.1.1
3. Next select the duration of the ban. It can be as short as 1 day and as long as Forever.
   Note: You can always delete a ban if you made it for too long or made a mistake
4. Add a reason for the ban so that you don't forget the reasoning behind it
5. Click Save and the user will then be added to your list of bans

To Delete a Ban, select the user you want to remove and the click Delete Ban - Show confirm screen

To Edit a ban, click the Edit link next to the Ban you want to edit. This will then open the following screen which will allow you to edit any part of the Ban including the Expiration and Reason. Once your changes have been made, click the Edit Ban button to apply the changes to the Ban.

Whenever a file is deleted on a Deki page, it will go into the Deleted files queue waiting for the Admin to approve it to be deleted or restored if it was accidently removed. To restore file(s), select the file(s) and then click the restore files button. To delete them, select the files you want to delete and then click the delete permanently button.

The Deleted Pages screen allows you to restore pages that have been deleted in the system. If you have a lot of deleted pages, you can search for the pages that you want to restore.

Cache Management allows you to manage your Search Index and your server side Cache.

1. If you need to update your search index, click the Rebuild Now button and your Search Index will be rebuilt. Depending on the size of your Deki deployment, this can take over 20 min. Note: MindTouch Deki automatically updates its indexes frequently. If you are experiencing issues with search, rebuilding the Index can help.


2. After updates to MindTouch Deki or changes to the User Interface it is a good idea to clear your server side cache. Thic can be done by clicking the Clear Now button.

Service Management allows you to add Deki extensions that integrate with external applications, services, and external authentication. By default the following extensions come pre-installed on Deki:

• RSS/Atom Reader
• Digg
• Flickr
• Gabbly
• Multimedia
• WidgetBox
• Windows Live
• Syntax Highlighter

To Edit an Extension Click the Edit link next to the Extension that you want to Edit.

To Restart, Stop, or Delete an Extension, Select the extension and then click either Restart, Stop, or Delete.

If you want to add a DekiScript Extension click the Add Script Link at the top of the screen. Then fill in the form as follows:

1. Give the Dekiscript extension a name that will be visible in the Extension list
2. In the Manifest field, paste the link that is included in the documentation for the extension
3. Debug mode reloads the script each time it is invoked which is helpfull when you are testing our DekiScript Extensions
4. If there are Config keys for the DekiScript, which will be referenced in the Extension installation documentation, click the Add New Key and then add the appropriate config keys
5. If there are any Preferences referenced in the installation documentation then you can specify them here
6. Once everything is configured click the Add Script and the New DekiScript extension will be added to the list of Available Extensions

To Add an Extension to MindTouch Deki:

1. Select where the Extension is Native or Remote. A majority of the Extensions you will add will be Native
2. Give the extension a name that will be visible in the Extension list
3. Copy and paste the SID for the Extension
4. Copy and paste the URI for the Extension
5. Add any configuration keys, if applicable
6. If there are any Preferences referenced in the installation documentation then you can specify them here
7. Once the form includes all of the information needed, then click the Add Extension button

Enter your Google Analytics Account ID to add Google Analytics Tracking to your MindTouch Deki.

1. Add a New Configuration Value
2. Default id
3. Enable caching of pages to reduce database calls. (default: false)
4. Enable caching of permissions to reduce database calls. (default: false)
5. Enable caching of permission roles to reduce database calls. (default: false)
6. Enable caching of authentication providers and extensions to reduce database calls. (default: false)
7. Enable caching of user data to reduce database calls. (default: false)
8. Whether or not to remove potentially unsafe html tags
9. Unallowed extensions as file attachments
10. File extensions that will generate image previews
11. Maximum image size for preview generation (setting this value too high may choke your memory usage)
12. Max file size for any attachment being attached to MindTouch Deki
13. To enable Multi Lingual support in MindTouch Deki add the appropriate Language acronyms here, see the User Manual for details on configuration and use of Multi Lingual
14. Username to associate with the main Administrator in case the Administrator uses a different username than Admin
15. Allowing Anonymous account creation will add a link on the Login Page that will allow anyone visiting the site to create an account, make sure you look at point 16 to ensure you have the proper role assigned if this is enabled
16. Length of Cookie expiration, used to managed logged in users session length before requiring additional login
17. Default user role that is assigned to newly created users through the web registration form
18. This is the location of your attachments within the file system
19. Default storage type
20. Google Analytics key, Manage through System Settings -> Google Analytics
21. Current user interface language, Manage through Customize -> Site Name and Language
22. Site Name of your MindTouch Deki install, Customize -> Site Name and Language
23. Current Skin that is being used by MindTouch Deki, Customize -> Logos & Skins
24. Current Template that is being used by MindTouch Deki, Customize -> Logos & Skins
25. Name of the MySQL catalog that MindTouch Deki uses for storage
26. Default database options
27. Default port to access the MySQL database
28. MySQL Server Name
29. Default user that MindTouch Deki uses to access MySQL
30. MySQL Server Host

In order to get a MindTouch Deki Enterprise License, contact MindTouch Sales via the contact information provided

1. You will then receive an xml file in an email the you will upload by clicking
2. Browse and then click
3. Activate License. This will then update your License Type. If you have any questions please contact either Sales or Support.