Pre Kilen Woods Control Panel

Understanding the MindTouch Control Panel

Above is the default MindTouch Control Panel for releases before Kilen Woods 8.08. To see the default Control Panel for Kilen Woods and later look at the documentation(link to new cp)

Bans

Bans allow you to block users from logging into your MindTouch install by banning their username or the IP address that they are accessing your MindTouch from. To ban a user 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. lick Save and the user will then be added to your list of bans

Once you click Save the user will then appear bellow the ban form and will give you details about the banned user. In the case above the user was banned by their IP on Aug 11 2008 with a duration of forever. The user was banned by the Admin and the reason was because the Vandalized the front page. As stated above you can always edit or delete any ban by selecting it and then clicking the Edit link or clicking the "delete selected bans" button

Configuration

The Configuration page in the Control Panel allows you to make changes to the MySQL config table through an interface. Any changes to the Configuration values should be made with caution and only by the Admin. Here is an explanation of all of the configuration settings:

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

Double Redirects

The Double Redirects management screen allows you to remove double redirects within the system. A double redirect occurs when a page is moved twice so that when you go to the original link it will redirect you to the final page. When managing these, make sure that the double redirect is not being referenced anywhere before you remove it.

Configuration of FCKeditor

The Configuration of the FCKeditor screen allows you to add/remove functionality of the default MindTouch editor which is FCKeditor

Group Management

To add a group into MindTouch enter the group(s) name(s) in the text box separated with semicolons. If you integrate with any external authentication services then the group name needs to be exactly the same as the group name in the external authentication sevice

1. Choose the access level that you want for the Group (Access levels are defined through the Roles Screen)
   and then
2. Select the Service that you want to associate the group with. Then click add groups

Configuring Local Groups

To configure Local groups click on the Edit Users

Now selet from the Available users list and click the Left arrow highlighted above to add the users to the group. Once you have selected all of the users that you want in the group select the update group. To remove users from a group click on the selected user(s) in the Group users column and then click the right arrow button. Note: only local users can be added to local groups.

Configuring External Authentication Groups

When you add an External Authentication Group the users are automatically associated with that group. When the user logs in to MindTouch it will check what groups it is a part of and will apply permissions accoardingly

Deleting and Editing Groups

To delete a group, select the group you want to delete, make sure that Delete is selected in the Drop Down and then click the right arrow.
To edit a group, follow the same steps for deleting except select Edit in the dropdown

Deleted Files

Whenever a file is deleted on a MindTouch page it will go into the Deleted files queue waiting for the Admin to approve it to be deleted or retore it 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

Restore

The Restore 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.

Roles management

Role Management allows you to specify the Roles for users and Groups. Each Role has the following role attribute that can be applied to a Role:

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.

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

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

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

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

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

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

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

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

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.

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

If you want to add a new Role, give it a name and then select the roles that will be associated with it. You can also manage the default role that a newly created user is assigned with.

Service Management

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

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

Adding an Extension

To add an extension click the Local link

1. The first step of adding an extension is to select whether it is an Authentication service or an Extension. An Authentication service allows you to integrate with extenal authentication providers like LDAP, AD, and more. Extension allows you to add integration with external applications and web services
2. Once you select the correct service give it a name in the Description field, this will be what the service is referenced as in the list of extensions
3. SID is a string that is associated with the extension that is included in the installation documentation for the extension
4. Config are various values that are required by extensions in order to work. These too are referenced in the install documentation
5. Preferences are also values, like parameters, that the extension will need. This is included in the install documentation
6. By default the status of the extension is set to Enabled. If you are not ready to go live with the extension just yet then you can select Disabled
7. The "Make default" option is unique to Authentication services and will make it the default authentication service on the login page. If you enable this you will see that the radio button will be selected next to this service on the login page
8. Once you have all of the required information included in the form then click the add service button and your service will be enabled in MindTouch and will be visible in the Insert Extension Dialog

Site Settings

1. Set the Site Language allows you to change the localization of MindTouch. MindTouch currently supports over 15 Languages
2. The Site Name is the name that will appear at the top of your MindTouch hierarchy and in the Header of the browser
3. Rebuild Search Index allows you to rescan your MindTouch Site and update your Search index
4. Allow anonymous account creation adds a "Register" link to the site along with a "Create Account" link on the Login Page which allows any visitor to your site to create an account on the site Make sure you look at the Default Role for newly created users which is an option under Roles
5. Disable Searching will turn off the search indexing which will not allow you to search any content on the wiki
6. Use content distribution networks for Javascript libraries helps increase the speed of javascript based content by using distibuted libraries
7. If you want to add analytics quickly to your MindTouch site you can do so by pasting your account ID in the text field.

Visual Appearances

Visual appearances allows you to change the skining and templating look for your MindTouch install. To start select a Site logo by clicking Browse and selecting a logo from your local hard drive and then clicking upload specified logo. Note: that the logo will be scaled down to 500 x 50

Customize site styles

Customize site styles allows you to override the CSS of the skin and of the content. The content is defined as the content on a wiki page, i.e. anything that is editable by the WYSIYWYG editor. The template CSS is the actual skin of the wiki, i.e. anything outside of the editable WYSIWYG area.

Change your styles

Changing the styles allows you to add a new look and feel to your wiki. If you add any custom templates/skins they will show up here to be activated by the admin.

Customize Site HTML

Customizing the site HTML gives you more control over areas of the skin/template. To customize the HTML areas, add HTML content in any of the boxes and then click the customize site html button. The areas are defined as follows:

1. HTML Section 1 is helpful for adding a custom header to the site to give your wiki a custom look
2. HTML Section 2 is good to add an extra link/button/image to spice up the side
3. HTML Section 3 is a good block to add content like RSS feeds or widgets
4. HTML Section 4 is a great place to add Google Adsense as it will be visible on everypage and will be inline with the content. Also a good spot for information relavent to the content
5. HTML Section 5 is a block that you can add copyright notices, privacy policy links, and any other verbiage that is best places in the footer
6. HTML Section 6 is good for Analytics and tracking code as this is right before the end of the body of the site

Unused Redirects

Unused redirects is the management screen for pages that have been moved once and their respective redirect. It is recommended to confirm that the redirect isn't being used any more before deleting it. To Delete a redirect, select it by checking the checkbox next to its name. Then at the top click the Delete all Selected link.

MindTouch Product Activation

The MindTouch Product Avtivation screen allows you to activate your MindTouch Enterprise edition. If you purchase a MindTouch Enterprise license then you would come to this screen, copy the API Key and send it to support. Support will then email you back your MindTouch Enterprise ID which you will copy into the MindTouch Enterprise ID field and then click upgrade. If you would like to get a MindTouch Enterprise ID, contact a MindTouch Sales Representative with the information above.

User Management

The User management page allows you to Add, Edit, and Deactivate users in MindTouch. To add a user do the following:

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 Auth interface as opposed to MindTouch's interface 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 Add the email of the new user so that they can receive system notifications including their new login credentials 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 Specify the role that you want this user to have - See Role Management for more details on what roles are available 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

If you want to add multiple users faster, click the Create multiple users link

Once users are added you will be able to edit or Deactivate them. Note: Users aren't Deleted from the system when you click Deactivate as this would lose all version history associated with that user along with other content on their User Page. To Edit or Deactivate a user click the checkbox next to the user and then select either Edit or Deactivate and then click the right arrow. The Search field and the Filter field help narrow down the users for editing/deactivating in a large user base.