XWiki Platform - User - UI
![]() | User profile UI |
Type | XAR |
Category | |
Developed by | |
Rating | |
License | GNU Lesser General Public License 2.1 |
Bundled With | XWiki Enterprise, XWiki Enterprise Manager |
Compatibility | XWiki 3.4M1+ (Before 3.4M1 this applications was part of the Administration Application) |
Table of contents
Description
The User Profile Application is bundled with XE/XEM and it allows users to change their profile preferences and follow the activity of other users
User Profile
You can easily access your user profile by clicking on your user name on the top right corner. The profile is also available by hovering the user name and clicking on Profile.
Initially your profile will only display your first and last names.
Add an avatar
You can start customizing your profile by adding an avatar. To do this click on pen icon located on top right corner of the avatar image above the Profile tab. Click Choose file/Browse, depending on your browser.
A pop-up will appear, which will allow you to select an image from you computer.
After you have selected the image click on Upload and select.
Congrats! You have successfully customized your avatar.
Edit your profile information
To edit your profile information all you have to do is click on the yellow pen located at the top of your profile.
In the Personal Information section you may edit your first name, last name, company and write some text about you.
You can fill in your contact details in the Contact Information section. You may add your email, phone number and physical address.
The External Links area allows you to add links to your blog and blog feed.
After you are done editing don't forget to save your changes. You have now successfully edited your profile to display information about yourself.
Customize the information to display in the Profile tab
Starting with 4.0M2, as an administrator, you can configure which information is displayed for all users in their user Profile tab from their user profile page.
To do this, go to Administration > Users & Groups > User Profile and configure which fields of the XWiki.XWikiUsers class to display and how these fields should be grouped into sections.
If you wish to define and use some new fields, go to the XWiki.XWikiUsers page in class editor mode and add the new fields you want. Go back to the User Profile administration page and use the newly added fields.
Note: Starting with 4.0RC1, you can more easily specify the text to be used as section name.
Recent Changes
The User profile displays a list of the pages that have been recently modified by the profile owner. This means for example if you create a new page, this event will show up in the My Activity Stream area of your profile.
User Preferences
The User Preferences section allows you to configure your editor and easily change your password. To access this section hover over your username in the top right corner and click on the Preferences link.
Edit Preferences
To change your editor preferences click on the yellow pen in the top right corner.
- Display preferences
- Display hidden documents: By default technical documents are hidden, in the same manner as some files are hidden by your Operating System (such as Windows, Mac OS or Linux). You can decide to display those documents.
- Enable extra accessibility features: This setting is useful for blind and visually impaired persons, it enables accessibility helpers in the User Interface.
- Localization preferences
- Timezone: You can define a different timezone than the one set by default.
- Editor preferences
- Default editor to use: You can choose between text and wysiwyg as your default editor
- User type: Select between simple and advanced user, depending on your wiki needs. By selecting the simple user you will have access only to the default editor. If you select the advanced user, you have a wide variety of edit options.
Change Password
To change you password, on the preferences page click on the Change password button. A new page will appear asking you to fill in the new password and reenter it. Click Update and you are done!
User Status
XWiki Enterprise has introduced the "User status" feature which supports the messaging and networking inside the wiki. The users can now share their status messages which will be visible on profile pages and on the main dashboard.
Share A Status Message
There are 2 ways of sharing a status message.
Sharing on the Main Homepage
You can share a post on the homepage by writing it in the text area below the Activity Stream. The message can be visible:
- to everyone
- to your followers - you can specify a follower like this: XWiki.UserName
- to a specific group (e.g.: XWiki.GroupName)
- to a specific user (e.g.: XWiki.UserName)
You will be then able to see the posts in your Activity Stream.
Sharing on Your User Profile Page
You can also share a message via your user profile page using the "Send Message" widget located "My Activity Stream".
Sharing on Another User's Profile Page
You can share status messages on other user's profile page. The posts will be visible by default only to that user.
Delete a Status Message
To delete one of your status messages:
Go to the "Profile" menu in the top right corner and click on "Network". Hover the post you wish to delete, click on the red "x" in the top right corner near the creation date and confirm.
Go to the main homepage, hover the post you wish to delete, click on the red "x" in the top right corner near the creation date and confirm.
Follow Other Users' Posts
To follow the posts of another user, go his user profile page and click on "Follow".
Notice that the "Follow" button is now named "Following".
Unfollow an User
To unfollow an user, you have 2 options:
Go to the user's profile page and click on the red "x" to the right of the "Following" button.
Notice that the "Following" button is now named "Follow".
Go to your user profile, choose the "Network" tab, then click on the "Unfollow" link located to the right of the corresponding user.
See the Members of Your Network
To see the members of your network, go to the "Profile" menu in the top right corner and click on "Network".
See the Network Activity
To see the network activity, go to the "Profile" menu in the top right corner and click on "Network". The status messages are listed in the right column.
Disable the Message Stream
To disable the message stream, click on "Administer Wiki" in the "Wiki" menu located on the top menu bar.
In the global administration page, click on "Message Stream" in the vertical menu to the left.
In the "Message Stream" administration page select "No" from the drop-down list, then click on "Save".
Prerequisites & Installation Instructions
We recommend using the Extension Manager to install this extension (Make sure that the text "Installable with the Extension Manager" is displayed at the top right location on this page to know if this extension can be installed with the Extension Manager). Note that installing Extensions when being offline is currently not supported and you'd need to use some complex manual method.
You can also use the following manual method, which is useful if this extension cannot be installed with the Extension Manager or if you're using an old version of XWiki that doesn't have the Extension Manager:
- Log in the wiki with a user having Administration rights
- Go to the Administration page and select the Import category
- Follow the on-screen instructions to upload the downloaded XAR
- Click on the uploaded XAR and follow the instructions
- You'll also need to install all dependent Extensions that are not already installed in your wiki
Dependencies
Dependencies for this extension (org.xwiki.platform:xwiki-platform-user-ui 5.0.3):
- org.xwiki.rendering:xwiki-rendering-macro-html 5.0.3
- org.xwiki.platform:xwiki-platform-messagestream-ui 5.0.3
- org.xwiki.platform:xwiki-platform-rendering-macro-include 5.0.3
- org.xwiki.platform:xwiki-platform-rendering-macro-velocity 5.0.3
- org.xwiki.platform:xwiki-platform-activitystream-ui 5.0.3
- org.xwiki.platform:xwiki-platform-attachment-ui 5.0.3