Getting started

This chapter covers the following topics:

Glossary

Terms which are commonly used in eXo Platform applications.

Welcome to eXo Platform

Introduction to what you need to do for the first startup of eXo Platform.

Social Intranet Homepage

Introduction to the Social Intranet homepage, the Social Intranet applications and how to change your language.

Signing in/Signing out Social Intranet

How to sign in and sign out Social Intranet.

Changing your account settings

How to change your account profile and password.

Forgot Password

How to request a link to reset your password.

Using the Activity stream

How to post status updates, share links and documents, delete activities/comments, comment on activities, or like/unlike activities.

Note

According to your roles, not all features described in this guide are available to you. Check with your administrator to assure which features are for your account or ask for more appropriate rights.

Glossary

This section provides a number of terms that you will encounter when implementing eXo Platform.

Site

A web-based environment which is used for aggregating and personalizing information via specific applications with an interactive and consistent look and feel. Users and administrators are able to integrate information, people and processes via a web-based user interface.

Portlet

An applicative component pluggable to a site through which users can access some specific information, including supports, updates, or mini-applications. The portlet produces fragments of a markup code that are aggregated into a page. Typically, a page is displayed as a non-overlapping portlet windows collection, where each portlet window displays a portlet. Content generated by a portlet can be customized, depending on the configuration set by each user. Portlets can be divided into two following types:

  • Functional portlets which support all functions of a site. They are built into the site and accessed via toolbar links when the site-related tasks are performed.
  • Interface portlets which constitute the eXo Platform interface as front-end components of the site.

Super-user

A super-user is a special user who has full privileges and used for the administration. In eXo Platform, this account is configured with Root, Root, root@localhost and its memberships are member:/organization/management/executive-board, *:/platform/administrators, *:/platform/users, *:/platform/web-contributors, *:/organization/employees. A super-user has all permissions on all features of eXo Platform.

Space

A collaboration workspace where you can share documents, tasks, events, wikis and more. A space can be open or closed, private or public and space administrators can manage members and applications that are available.

Connection

A bond among people in a network. By connecting to other people, you will be able you to track their activities through the activity stream.

Activity

An activity is published on the Activity Stream and allows you to follow what your connections are sharing, such as links to documents or just moods. An activity can be made out of different parts:

  • The author
  • The author’s avatar
  • The space
  • The type of the activity (for instance Documents, Wiki, Forums, Spaces or Connections)
  • The activity message
  • The featured content
  • The action bars including the buttons Comment and Like
  • The like section
  • The comment section

Gadget

A mini web application which is run on a platform and can be integrated and customized in the website. You can add these gadgets to your dashboards by yourself.

Modes

eXo Platform offers two access modes by default:

  • Public mode is for guest users (visitors) who are not registered. In this mode, you are not required to sign in, but limited to public pages in the site. After being registered successfully, you can use the private mode, but must contact the site administrators to get more rights or the group manager to become the member and gain the access to the group.
  • Private mode is for registered users who will apply their usernames and passwords to sign in. This mode supports users in taking many actions, such as creating private pages, editing or deleting them, “borrowing” pages from others by creating hyperlinks, changing languages to their individual needs, managing private information.

Permission

Permission settings control actions of a user within the site and are set by the administrators. See Managing permissions <Administration.ManagingPermissions> for more details.

Repository

A locus where content or digital data are maintained. Users can access without traveling across a network.

Drive

A shortcut to a specific location in the content repository that enables administrators to limit visibility of each workspace for groups of users. It is also a simple way to hide the complexity of the content storage by showing only the structure that is helpful for business users.

In details, a drive consists of:

  • A configured path where the user will start when browsing the drive.
  • A set of allowed views that will allow the user to limit the available actions, such as editing or creating content while being in the drive.
  • A set of permissions which limits the access and view of the drive to a specified number of people.
  • A set of options to describe the behavior of the drive when the users browse it.

Node

An abstract unit used to build linked data structures, such as linked lists and trees, and computer-based representation of graphs. Nodes contain data and/or links to another nodes. Links between nodes are often implemented by pointers or references.

Also, a node can be defined as a logical placeholder for data. It is a memory block which contains some data units, and optionally a reference to some other data. By linking one node with other interlinked nodes, very large and complex data structure can be formed.

WebDAV

This term stands for Web-based Distributed Authoring and Versioning. In eXo Platform, it is used as a mean to access the content repository directly from the Sites Explorer.

Welcome to eXo Platform

eXo Platform is a full-featured application for users to have many experiences in building and deploying transactional websites, authoring web and social content, creating gadgets and dashboards with reliable capabilities of collaboration and knowledge. When you initialize eXo Platform for the first time, the Terms and Conditions Agreement screen is displayed as follows:

image1

Note

The Terms and Conditions Agreement screen appears in the Commercial editions only. In the Community edition, the Account Setup form appears for the first time.

This agreement contains all terms and conditions that you need to read carefully before deciding to use eXo Platform. By ticking the checkbox at the screen bottom, you totally agree with the eXo Platform’s terms and conditions. Next, click Continue to move to the Account Setup form.

image2

The Account Setup window consists of 2 sub-forms:

  • Create your account: Create your primary account.
  • Admin Password: Change the default password of the “root” user. You can use this account to log in eXo Platform as a super-user who has the highest rights in the system.

You can select Skip to ignore this step, then sign in as the root user with the default password (gtn).

Setting up your account

  1. Enter your information in fields.
  • It is required to fill all fields, except the Username field of the Admin Password form, which is pre-filled with “root” and disabled. See Adding auser for more details.
  • Values entered in both Password and Confirm fields must be the same.
  • You can change these entered information after logging in eXo Platform. See Changing your account settings for more details.
  1. Click Submit to finish setting up your account.

Once your account has been created successfully, a Greetings! screen appears that illustrates how to add more users.

image3

3. Click Start to be automatically logged in with your created account and redirected to the Social Intranet homepage. Now, you can start adding more users to collaborate, creating/joining spaces, or creating/following activities.

Note

  • After your accounts have been submitted successfully, the following memberships will be granted to your primary account:
  • *:/platform/administrators
  • *:/platform/web-contributors
  • *:/platform/users
  • *:/developers
  • If the server stops before your account setup data is submitted, the Account Setup screen will appear at your next startup.

Social Intranet Homepage

This section introduces you to the Social Intranet homepage. Besides, you will further learn about the following topics:

After signing in your account successfully, you are redirected to the Social Intranet homepage, the starting point for exploring eXo Platform. This homepage provides you a perfect overview of all social and collaboration activities available in eXo Platform.

image4

There are 3 main divisions in the Social Intranet homepage:

Navigations

  • Top navigation image5: Take common actions via the following menus:

    • Help: Access online guides by clicking image6. For example, if you are in the Wiki application, but still not know how to get started with it, simply click image7. You will then be redirected to the instructions page regarding to Wiki in another browser tab.

    • User Profile: Change your profile information, preferences, language or quickly navigate to your personal pages by clicking your display name, for example: John Smith.

    • Notification: Clicking image8 will show all on-site notifications. See Managing your notifications for more details.

    • Search: Search for any types in eXo Platform, such as people, spaces, files, events, tasks, activities, by clicking image9. See Searching In eXo Platform for more details.

    • Create: Quickly create content (Wiki pages, topics, polls, events/tasks, files) from any places by clicking image10. See Creating content quickly for more details.

    • Administration: Perform advanced actions, such as managing users, content, applications, monitoring your system or organizing sites, by clicking image11. This menu is only visible to members of the web-contributors and administrator group.

    • Edit: Manage certain aspects of eXo Platform, including content, pages and sites by clicking image12. This menu is only visible to members of editor and administrator groups. See Customizing eXo Platform for details.

      Note

      The number of menus which are displayed on the top navigation may vary, depending on your role. For example the administration menu appears only for members of the group /platform/administrators.

  • Left navigation image13: It is a hamburger menu which allows you to quickly jump to :

    • Applications: By default, the following applications are available:
      • Home: To come back to your social intranet homepage from any page.
      • People: To display the whole list of the platform users. You can manage your connections, search for users using different filters…
      • Wiki: To go to your social intranet wiki application which is shared between all users.
      • Documents: To go to documents application where you can manage your personal drive and shared files.
      • Forums: To go to your social intranet forums application where you can post and reply to discussions.
      • Calendar: To go to calendar application and view personal and shared calendars.
    • Pages shared by all users in the COMPANY list.
    • Spaces in the “MY SPACES” list. It is also possible to search for spaces by clicking on Join a space.

    This hamburger menu is collapsible in order to widen the area for the activity stream:

    image14

    When connecting to the platform, the menu is by default expansed. To collapse or expand it, you should click on the hamburger menu icon image15.

    When collapsed, the left navigation menu displays only application’s icons. Mousing over an icon displays a tooltip with the application’s name. Clicking on an icon redirects you to the concerned application.

    Note

    • The order of applications and pages in the COMPANY list may change in case some applications are not deployed, or some additional applications/pages are implemented.
    • The MY SPACES list shows the latest spaces browsed by the user. If there are more than 10 spaces in the list, the Show [X] More Spaces link appears at the list bottom. Click this link to view more spaces.
    • The Show [X] More Spaces link is not displayed when the left navigation menu is collapsed. It is only available if the menu is expansed.
    • When the left navigation menu is collapsed, spaces search is not possible as the search field is not available. To search spaces, you should expand the left navigation menu.

Activity Composer image16 & Activity Stream image17

  • From Activity Composer, you can update your status, upload and share your document/link. See `Updating status <Share-AS>`for more details.
  • From Activity Stream, you can follow activities of your colleagues and spaces, create your own activities (liking or commenting). See Using the Activity Stream <Share-AS> for more details.

Applications image18

Quickly perform key actions through the following applications:

Creating content quickly

In eXo Platform, you easily create your preferred content without navigating to its relevant application. Simply click image33 to open the drop-down menu.

image34

Here, you can do the following actions quickly:

Creating a task

  1. Simply select Task from the drop-down menu. The menu will be updated into the Create a new task form.

image35

  1. Fill in the Title field, and then hit the button Add.

After saving, a pop up link appears image36 which points to the created task.

Creating an event

  1. Simply select Event from the drop-down menu. The menu will be updated into the Add event form.

image37

  1. Give details for your event, including: Title, From and To dates, time. For more details, see Creating a new event.
  2. Select the calendar where your event will be created from the Select Calendar drop-down menu.
  3. Click Save to add your event.

A pop up image38 appears indicating in which calendar the event was added.

Note

Click Cancel at any time to dismiss the Add event form.

Creating a poll

  1. Click Poll from the drop-down menu. This menu will be updated into the form as below:

image39

Note

If there is no forum available in Intranet and the user has no space forum yet, the following warning is displayed: “Sorry, no forum is available yet to create a poll. Start by creating your own space.”

  1. Select the location where your poll is created from the In Location menu. If you have at least one public forum, the “intranet” location is selected by default.
  2. Click Next to open the Poll form, or Cancel to dismiss the form.
  • If you select a space forum, you will be redirected to the Forums application of the selected space after clicking Next.

  • If you select “intranet” which has more than 1 forum and then click Next, another new selection menu will be opened. The Next button now becomes disabled until you have selected one forum from the And Forum menu.

    image40

  1. Fill in the Poll form. See Creating a poll for more details.

Creating a topic

  1. Click Topic from the drop-down menu.

    Note

    If there is no forum available in Intranet and the user has no space forum yet, the following warning is displayed: “Sorry, no forum is available yet to create a topic. Start by creating your own space.”

2. Select the location where your topic is created from the In Location drop-down menu. The “intranet” is selected by default.

  1. Click Next to open the New Topic form.
  • If you select a space forum, you will be redirected to the Forums application of the selected space after clicking Next.

  • After clicking Next, if you select “intranet” which has more than 1 forum, one new selection will be opened that requires you to select your desired forum as below. The Next button becomes disabled until you have selected one forum.

    image41

  1. Fill in the New Topic form. See Creating a topic for more details.

Uploading a file

Simply select Upload a File from the drop-down menu. See Sharing a File for more details.

Creating a Wiki page

  1. Click Wiki Page from the drop-down menu.

image42

  1. Select the location where your Wiki page is created from the In Location drop-down menu. The “Intranet” space is selected by default.
  2. Click Next to be redirected to the Wiki application of your selected location. Here, you can navigate across spaces.
  3. Enter the content of your Wiki page. See Creating a page for more details.

Social Intranet applications

Intranet applications are ones which come with the Social Intranet homepage, including:

Getting Started

The Getting Started application is displayed first in the list of the Intranet homepage applications on the top right. This application helps you start exploring the Social Intranet by suggesting you where to go and what you should do first via the following links:

image43

Clicking each link will direct you to the related page to do the action.

After each action is performed, it will be remarked as completed with a strike-through even though it is not performed via this application. Also, the completion percentage is updated on the percentage bar.

When all the actions are performed, the completion percentage will be 100%. You can remove this application from the homepage by clicking Close or by hovering your cursor over the application header, and click image44.

image45

Note

  • You cannot get the Getting Started application back when it is removed.
  • The “Upload a document” action is considered as completed only when a document has been uploaded in your Personal Documents drive.

Calendar

The Calendar application displays some calendars and all of their events and tasks scheduled in the Calendar applications of Intranet and spaces. When going to the homepage, you will see events with their start and end date and tasks of Today. You can also see the events and tasks of the previous/next day by clicking the previous/next arrow respectively.

image46

  • To view details of an event/task directly in the Calendar application, click your desired event/task.

  • To configure and set which calendars to be displayed in the Calendar application, hover your cursor over the application, then click image47 at the right bottom of the application.

    • To remove a calendar from the list of Displayed Calendars, click image47.

      This removed calendar will appear in the list of Display Additional Calendar.

    • To add one of removed calendars again to the list of Displayed Calendars, simply hover your cursor over the desired calendar, then click image48. You can use the Search box to filter calendars quickly.

    • Click OK to accept your settings.

    Note

    When a task is completed, it will be remarked with a strike-through.

Invitations

The Invitations application shows a list of spaces and users who have sent you connection requests. You can see the number of requests displayed next to the application name.

image49

  • For a user’s connection request, you will see his avatar, name and title (if defined).
  • For a space’s connection request, you will see its avatar, name, the number of members and know if it is public or private.

You can accept/refuse an invitation by hovering your cursor over a user/space’s name, then clicking Accept or image50 respectively.

When the invitation is accepted or refused, it will permanently removed from the list.

Note

The Invitations application is not displayed when there is no invitation.

Suggestions

The Suggestions application suggests you to connect with other users or to join spaces. Usually, it suggests two people having the most common connections with you, and two spaces having the most members who are your connections. Otherwise, it will suggest the newest users or the latest created space in the portal.

image51

  • To accept the people/space suggestion, hover your cursor over their names and click Connect or Request respectively.
  • To refuse the suggestion, hover your cursor over the people/space names and click image52.

When the suggestion is accepted or refused, it will permanently removed from the list.

Note

  • You can click a person’s name suggested in the list to see his profile.
  • If there is no suggestion, the Suggestions application is not displayed.

Who’s Online?

The Who’s Online? application shows all users who are already logged in the portal.

image53

Hover your cursor over the avatar of an online user, a pop-up will show you some information about him, such as name, avatar, current position (if defined), and the last activity message of status activity, file or link sharing activity (if any).

You can also see your connection status with an online user via the corresponding button at the pop-up bottom:

  • If you are not connected with him yet, the Connect button is to send connection invitation to him.

  • If you have sent a connection request, the Cancel Request button is to revoke your connection request.

  • If you are invited to connect, the Confirm button is to accept his connection request.

  • If you are already connected with him, the Remove Connection button is to delete connection between you and him.

    Note

    From the pop-up, you can click his avatar or display name to jump to his activity stream page.

Changing the UI language

To change the language of eXo Platform, do as follows:

1. Click your display name on the top navigation bar, then select Change Language from the drop-down menu.

image55

2. In the Interface Language Setting form, you will see 23 languages that eXo Platform supports. Select your preferred language to display, for instance English:

image56

  1. Click Apply to commit your changes.

    Note

    In eXo Platform, the priority order of the display language is as the following: User’s language –> Cookies’ language –> Browser’s language –> Site’s language It means the language set by the user will be at the highest level, and the site’s language at the lowest level. Accordingly, you should pay attention to this order when selecting your preferred display language.

Signing in/Signing out Social Intranet

Signing in Social Intranet

Note

To sign in Social Intranet, you must have an account. Your account is created by the Administrators and you can change your profile and password later. See how to add a new user in the Adding a user section.

You can sign in Social Intranet by doing as follows: image19

  1. Input your Username and Password in the Connect to you account form.

Switch Stay signed in to Yes if you want to automatically return to this portal without signing in again. This feature enables you to be automatically authenticated to avoid doing an explicit authentication when you access the site.

2. Click Sign in. If your account has been suspended, one message says that “This user account has been suspended. If you think this is an error, please contact the administrator.”.

Note

After selecting Stay signed in, if you do not sign out when you leave the portal, you will be automatically authenticated for your next visit.

Signing out Social Intranet

To sign out, simply click your display name on the top navigation bar, then select Logout from the drop-down menu.

image20

Managing Account

To change your account information, click your display name on the top navigation bar of the site and click Settings from the drop-down menu.

image21

The account settings appears.

image22

Changing your profile information

1- Select the Account Profiles tab.

2- Change your First Name, Last Name and Email. Your Username cannot be changed.

3- Click Save button to submit your changes.

Note

The email address changed must be in the valid format. See details about the Email Address format here.

Changing your password

1- Select the Change Password tab.

image23

2- Input your current password to identify that you are the owner of this account.

3- Input your new password which must have at least 6 characters.

4- Re-enter your password in the Confirm New Password field.

5- Click Save button to accept your changes.

Note

The users who just did their login via the social networks will not have a password defined. They should be able to reset a password via their Account Settings or via the Forgot Password feature or ask the administrator to set it (in the Manage Community page). Once the password is set, the user can either log in via the login/password or via the social networks.

When the reset password link is clicked: - An information message is displayed: Reset password guidelines have been sent to you. Please check your mailbox. - The Forgot Password function is executed, and the users receive an email to guide them to change their account password.

Managing your social networks

If your administrator does not integrate OAuth with eXo Platform, you will see one message “No social network available”. If any social network is integrated, you will see the following that allows you to link/unlink your account to the social networks.

image24

  • The text fields are read-only. Each has a value when the eXo account is linked with a social network account; otherwise, it is empty.
  • A social network username can only be associated with a single eXo account at one time. Hence, if one attempts to link with a username that is already linked to another account, an error message is displayed: This {$Network} username ({$Username}) is already linked to an eXo username. Please enter another one or ask your administrator to unlink it.
  • When you click the Unlink button, the link between the social network and the eXo Platform account is reset to blank. Hence, this username can be used to link another eXo account.

Forgot Password

If you forget your password, you can request the system to send you a link to reset it. The link will be sent to your email. It helps if you forget the username also, but it requires an email that is set in your account properly.

  1. In Login screen, click Can’t access your account? link.

image24

  1. In next screen, input your username or email, then click Send.

image25

  1. Check your mailbox. The email looks like this:

image26

4. Click the link in the email, then input your new password and click Save.

image27

If the password is saved successfully, a popup will notify you in seconds, then you are redirected to the Login screen.

In case the link has been expired already, you will see a notification like this:

image28

The link expires as soon as you successfully reset the password, or after 1 day by default. The system administrators can configure the expiration time.

Using the Activity Stream

After logging in, you will be directed to the Intranet homepage as below.

You can see activities of other users by clicking their display name to reach their profile page, then selecting Activity Stream. However, for people that are not in your connections, you only can view their activities but cannot post, comment or like on their activity streams.

The homepage also aggregates activities from spaces, so you can keep track of their activities without visiting every space. For example, when there is a new post in a forum of a given space, it is displayed in Activity Stream of the space and of the Social Intranet homepage.

You can filter what you want to see on the homepage:

  • image29 All Activities: shows all activities from spaces, connections and your activities. This stream is selected by default.
  • image30 My Spaces: only shows activities created in spaces where you are member.
  • image31 Connections: shows activities created by your connections.
  • image32 My Activities: shows your activities (inside and outside a space) and activities where you were mentioned in, that you liked or where you left comments.

To access your Activity Stream page, click your display name on the top navigation bar, then select My Activities.

You will be then directed to your Activity Stream page.

Note

In Activity Stream, the order of activities is based on the last date when you create a publication action, or post a new comment. This means the last publication or comment will be auto-updated and pushed up to the top of the Activity Stream so that you will not miss any recent activities.

Sharing in the activity stream

Using the acivity stream, you are able to share with your connections or other space members (in the space’s activity stream):

  • A text Message to ask for help or to inform something.
  • A link.
  • A single file or many files.

image57

Posting a text message in the activity stream

To share a text message with your connections or to other space’s members, follow these steps:

1. Click on Message tab form the activity composer, an area for message composing appears with a formatting toolbar.

image58

  1. Type your message, you can format it using the buttons of the formatting toolbar:

image59

  • image60: Selecting a text then clicking on that button makes it in bold format.
  • image61: Selecting a text then clicking on that button makes it in italic format.
  • image62: Selecting a formatted text then clicking on that button eliminates the formatting on it.
  • image63: Allows to add/remove a numbered list.
  • image64: Allows to add/remove a bulleted list.
  • image65: Allow to quote a text.
  • image66: Allows to insert a link in the text message.
  • image67: Allows to attach an image to the text message.

Click on image68 button to share the message in the activity stream.

image69

Posting files in the activity stream

You can share a file or many files with your connections or in a space’s activity stream by following this procedure:

Click on File tab form the activity composer, an area allowing to upload file appears:

image70

Select the desired file or files. More details in Share multiple documents in activity stream section.

You can add a text message or not and then click on image71 button to share the file(s) in the activity stream.

image72

The formatting toolbar in activity messages and comments

The formatting toolbar (or the microblog component) is present at every place where you can add text message. It allows you to:

  • format your text: bold, italic, numbered list, bullet list
  • quote a previous message.
  • insert a link in your status message/comment
  • insert an image in your status message/comment.

toolbar

Text formatting in the microblog

You can format your text to make it richer and more readable by using different effects.

Select the text you want to format. Then click on one of the buttons from the formatting toolbar to apply its effect:

  • image79 The first button formats the text as bold.
  • image80 The second button formats the text as italic.
  • image81 The third button clears the existing format.
  • image82 Writing a text then clicking on the fourth button adds the text to a numbered list. Clicking on Enter button of the keyboard adds a new line with the following number. When the listing is finished, to exit from the numbered list, you should click twice on Enter button of the keyboard.
  • image83 Typing a text then clicking on that button adds a bullet list. When you finish your listing, you need to double click on Enter button of the keyboard.

Quote text in the microblog

The formatting toolbar allows you to quote a previous text message. To do this, click on the Quote button image84 and then copy and paste the text you want to quote.

Double click on the Enter button on your keyboard to leave the quote area.

image85

Insert image in the microblog

The last button of the formatting toolbar in the microblog is the Insert Image button allowing you to insert an image in your message/comment.

To insert an image in your text message/comment, follow these steps:

  1. Click on the Insert Image button image92 to open the Select image form.

image93

You have four options:

  • Drop an image: drag and drop an image from your computer. A progress bar will appear to indicate the upload progress.

    image94

    When the upload has ended, the image will appear in the dedicated area.

    image95

  • Upload an image from your desktop: It allows you to select an image from your computer. Browse for the image and double-click on it to select. A progress bar will appear to indicate the upload progress.

    When the upload has ended, the image will appear in the dedicated area.

  • Select on server: select an image already on the server from your drives. Clicking on the link opens the Select files form.

    image96

    Navigate through your drives and then select an image. This will be directly displayed in the dedicated area.

  • Pick an image online: insert an image using its URL. Paste the image link into the Image URL field. An upload time will appear and the OK button will be greyed.

    image97

    When the upload has ended, the image will appear in the dedicated area and the OK button will become clickable.

    Note

    Click on the Cancel button to return to the screen showing the options. When picking an image online, click on the Back button. This button will disappear when the image is fully uploaded.

  1. To choose the alignement you want, click on one of the three buttons.

image98

3. Click on the OK button. The image will appear in the comment/message area.

image99

  1. To resize, hover over the image to bring up a black frame. Manipulate the frame to the size you want.

image100

  1. When you right click on the image, a contextual menu appears:

image101

  • Click on Copy followed by Paste to duplicate the image in the editor.

  • lick on Cut followed by Paste to move the image to another location in the editor.

  • Click on Change Image to open the Insert Image form prefilled with:

    • the image preview.
    • the image alignment as previously selected.
    • the Remove Image link allowing you to remove the image and start again.
  • Click on Link to open the Link form allowing you to insert an image using its URL.

    Note

    After you’ve finished resizing the image and posted it in the activity stream, the image will appear with the exact size you defined. Otherwise it appears in its default size.

Mentioning someone

Mention is a way to refer to people so that they are informed of who and what you are talking about. Mentioning someone is possible in activity stream composer, activities comments and also document comments. To mention someone, do as follows:

1. Type the “@” symbol into the activity/comment composer, then type the person name you want to mention.

A suggestion list that contains matching characters will appear.

Only one person can be selected at one time.

Note

When mentionning a user with “@”, it displays in first positions contacts in your connections, then other people

image102

2. Go through the suggestion list with the “Up” and “Down” arrow keys or by moving your cursor over it, then click or hit the “Enter” key to validate your selected person.

Note

Only one person can be selected at one time.

After being validated, “@” and following characters will be replaced with First name and Last name which are wrapped in a label. You can click [x] in the label to dismiss it.

image103

In the Activity Stream, the mention is displayed as a link to the mentioned user’s profile page.

image104

Note

  • You can do the same steps above to mention someone in your comments (document comments and activity comments).
  • The person you mention also sees the post in his/her Activity Stream.
  • Document comments appears also in the Activity Stream.

Deleting activities/comments

You are allowed to delete your activities/comments that you created, and those in your activity stream and in the space where your are the manager.

  1. Change the activity filter to All Activities or My spaces to view all of your activities.

image105

2. Hover your cursor over the activity you want to delete, then click image106 that appears.

image107

  1. Click OK in the confirmation message to accept your deletion.

    Note

    As an eXo Platform user, you can only delete your own activities. If you are manager of a space, you can delete any activities related to this space.

Commenting on activities

This action allows you to get ideas, answers, and any additional information when your collaborators respond to your status updates. Besides, you can comment by yourself about any activities as follows:

  1. Click image108 on the the activity you want to comment.

image109

2. Enter your comment into the Comment box and press the Comment button. Your comment will be displayed right after the activity.

Note

A formatting toolbar appears once you click in the comment composer. It allows you to change the formatting of your message, attaching images and links and preview how it will look once posted. (like what we have for the activity stream composer)

When there are more than two comments on activity, 2 latest comments will be displayed below the activity. You can click “View all XX comments” (XX is the total number of comments) to view 10 more comments. If some comments left are not displayed yet, click View previous comments on the top of the comment part to view more.

viewmore

You can mention people in your comment by “@” symbol into your activity composer, then type the person name you want to mention. See Mentioning someone for more details.

Liking activities

You can “Like” an activity to show your interest and support to that activity.

Liking an activity

Click image110 under the activity you like, a tooltip appears image111. When you like an activity, the “Like” button will be highlighted to show that you already click “Like” on that activity. The activity displays the information of like numbers or people who also like the activity right below it. If many people have liked the activity, you can click image112 to expand the view to see other “likers”.

image115

Unliking an activity

To unlike a “Liked” activity, simply click image113.

When disliking, a tooltip dislike appears. image114

Liking comments

With eXo Platform 5, it is possible to express emotion on a user’s comment to a status or any other activity by liking the comment.

Under the comment text, a like icon is displayed image116 which has 2 statuses:

  • The active status: When a user clicks on the like button, it turns to blue color.
  • The inactive status: The button is greyed when it is unclicked or clicked twice i.e first for liking and the second for removing like.

Clicking on the like button adds a number between brackets which indicates the number of users who already liked the comment. If the like button is already clicked and the user reclicks on it, it becomes inactive and the number is decreased by 1.

  • Mousing over the number between brackets shows a popover which indicates the persons who liked the comment.

    image117

  • If the number of likers is more than 10, the pop over shows 9 usernames and “X-9 more”. To view the full list of usernames, you should click on the number between brackets.

    image118

  • Clicking on the number between brackets displays a popup named People who liked which lists the users who clicked the comment. The pop up contains:

    • The user avatar.
    • The user name.
    • And one of these three buttons ahead each liker name:
      • Remove connection to delete a user from your connections.
      • Cancel Request to cancel a user invitation.
      • Connect to send an invitation to a user or accept his invitation.

    image119

Liking comments on documents preview

The like on comments feature is available for the documents preview.

It behaves the same as in the activity stream:

  • Mousing over the number between brackets displays a pop up with the names of the likers in a list.
  • To display the whole list when the number of likers exeeds 10, you should click on the number between brackets which displays the form People who liked.

image120

Replying to comments

In addition to Liking comments feature in eXo Platform, it is possible to reply to a comment.

Under each comment, a Reply button appears allowing you to reply to that comment:

image121

When you click on the Reply link, a comment composer appears with your avatar just below the last reply if it exists:

image122

When you click on the comment composer to type your message, a rich text editor toolbar appears allowing you to format your text:

image123

When more than two replies are posted to a comment, the replies are collapsed and a link to View all X replies (X is the total number of replies) is displayed allowing to view the whole replies.

image124

Note

Some other details about the reply to comment feature: - There is only one level of replies, it is the reply to comment. There is not a reply to a reply. - Deleting a comment with replies induces the replies deletion. - In addition to activity stream comments, the reply to comment feature is available for activities of these applications: Documents preview, forum and tasks. - Same as for comments, it is possible to like replies except in tasks application.

Reply to comment for Forum application

As mentioned above, the reply to comment is also available for forum posts activities:

  • When you reply to a comment in the activity related to a forum, the reply will appear as comment in the forum application which quotes the original comment.

    image125

  • When you post a reply to forum topic and quote the previous post, it will appear as a reply to the first comment of level 1 in the corresponding activity.

    Note

    When you use the quote option image126 of the CKeditor toolbar in the reply to comment, it will be considered as a simple quote. image127

Reply to comment notifications

When someone replies to your comment, you receive an onsite notification which contains:

  • The avatar of the user who replied to your comment.
  • A label: “UserA has replied on one of your comments”.
  • The reply timestamping.
  • The comment to which the user replied and if the comment is too long, an ellipsis of it.

image128

All the watchers of the activity i.e it’s likers and the space’s members if it is a space activity receive a simple comment notification.

When a user replies to an another user’s comment to your activity:

  • The user who commented your activity receives a reply to comment notification.
  • You receive a simple comment notification.

If the email notification is enabled, you will receive an email when someone replies to your comment which contains:

  • The label “User X has replied to one of your comments. See below:”
  • Your comment content.
  • The source link i.e the platform link.
  • The user name who replied followed by his reply.

image129

A new line in my notifications settings is added to manage reply to comment notifications:

image130

Default values are:

  • Send me an email right away: checked.
  • Send me a digest email: Daily.
  • See on site: checked.