Bloggers recientes

Melanie Chung

Staff
3 Mensajes
25 de julio de 2016

Patrick Chung

Staff
1 Mensajes
25 de julio de 2016

Bryan Cheung

Staff
35 Mensajes
18 de julio de 2016

Jamie Sammons

Staff
4 Mensajes
14 de julio de 2016

David H Nebinger

24 Mensajes
13 de julio de 2016

Maarten van Heiningen

1 Mensajes
13 de julio de 2016

Koen Olaerts

1 Mensajes
11 de julio de 2016

Victor Zorin

2 Mensajes
9 de julio de 2016

Neil Griffin

Staff
54 Mensajes
6 de julio de 2016

David Truong

Staff
17 Mensajes
5 de julio de 2016
« Atrás

New in 6.2: The new 'Dockbar'

General Blogs 29 de octubre de 2013 Por Jorge Ferrer Staff

Hey guys,

The 6.2 release is almost out and I want to use this opportunity to talk about some of the improvements we have done to the dockbar. For those newer to Liferay, the Dockbar is the nick name for the bar that appears at the top of the screen and provides personal and administration options to users. In 6.1, this bar looked like this:

Although, of course it is possible to customize it. For example, here at liferay.com it currently looks like this within my blog:

In some other portals I've seen people just remove the dockbar except for for administrators. While this is something easy to do from the theme, I always advice people to use it as a last resort. The reason is that Liferay has a very flexible permission system and when a user has some management permissions for the current site or page the dockbar is where those editing options will appear. Liferay has some advanced logic to determine what options to show to each user, but you probably won't want to replicate that logic in your theme to determine when to show the dockbar and when not to.

For 6.2 we wanted to improve the Look & Feel of the dockbar as well as its usability. But we also wanted to make it less intrusive, easier to customize. Among other reasons we wanted to reduce the situations in which there was a need to remove the dockbar altogether.

After doing the proper analysis and quite a few discussions between Nate, Juan Hidalgo, Ed Chung and myself made the most visible decission: In 6.1 the dockbar is a full horizontal bar, that goes from left to right. While this is not so bad for intranet-like environments, it is often not desired in public sites. Furthermore, for regular users who only saw his name in the par it was a significant waste of space. We decided that the bar would float from the right top edge (with some padding) and grow towards the left as needed. Thanks to this, we save tons of screen real state, specially for regular users who just see this:

Let's see this in the context of the whole page. As you can see below, by placing the dockbar to the right the site logo and name become more relevant, which is what is desired in most situations:

 

If the user belongs to at least one site and has some administration priviledges then two additional menus appear:

  1. My Sites: Shows the sites that the user belongs to, with direct links to the public and private pages (if they exist).

     
  2. Admin: Contains a link to the Control Panel if the user has access to it and direct links to the site administration sections (Pages, Content, Users and Configuration) that the user has access to. The direct links to each section was one of the last additions based on early user feedback and it has two benefits: It requires fewer clicks to perform any administration operation and it shows the type of things the user will be able to manage for this site even before clicking them.

 

That's it for now. I'd love to hear your feedback on these changes.

Also, feel free to let me know what other features or improvements of the dockbar or Liferay 6.2 in general that you would like us to cover in upcoming blog entries.

Respuestas anidadas Autor Fecha
A little off topic but I really really like the... Ronald Sarayudej 29 de octubre de 2013 6:19
Whoops, sorry Jorge, posted the above as Ron... James Falkner 29 de octubre de 2013 6:20
Hey James, I'm glad you like the idea.... Jorge Ferrer 29 de octubre de 2013 7:58
I was looking at the notifications and... Joseph Toman 29 de octubre de 2013 12:34
It shows any notification sent using the... Jorge Ferrer 30 de octubre de 2013 2:26
Denis, Jorge, thanks! Is there a portlet or... Joseph Toman 30 de octubre de 2013 9:22
Hey Joseph, I don't think that exists, because... Jorge Ferrer 30 de octubre de 2013 10:55
I believe... Vicki Lea Tsang 10 de noviembre de 2013 23:05
Hi @Joseph I was investigating by myself on... Denis Signoretto 30 de octubre de 2013 2:37
Hi Jorge , Can you please help me to notify... Anshul Sharma 21 de mayo de 2014 4:07
I like the new dockbar notification... David Kubitza 30 de octubre de 2013 3:27
Very nice work on this for v6.2, folks. A... Ben Uphoff 12 de marzo de 2014 14:50
Hey Ben, As of 6.2, I think the easiest way is... Jorge Ferrer 13 de marzo de 2014 10:32
Thanks much, Jorge. We also got this clue from... Ben Uphoff 13 de marzo de 2014 11:44
Hi Jorge, you wrote: "since it's a JSPf you... Jack Bakker 21 de septiembre de 2014 17:26
[...] UI/UX Refinements - Too numerous to list... Anónimo 15 de marzo de 2014 1:07
Hello Jorge! I have a problem about dockbar in... Yamina AZIZ 18 de julio de 2014 0:58
Hey Yamina, I'm pretty sure that this is a bug... Jorge Ferrer 18 de julio de 2014 2:22

A little off topic but I really really like the combination of the new dockbar + control panel differentiation (separation between site admin and portal / system admin).

Is it possible to put custom items into the dockbar? I could see some plugin or site admin wanting some super-commonly-used link in there.
Publicado el día 29/10/13 6:19.
Whoops, sorry Jorge, posted the above as Ron but it was really me who was asking! Ron, stop using my account! ;-)
Publicado el día 29/10/13 6:20 en respuesta a Ronald Sarayudej.
Hey James,

I'm glad you like the idea.
Regarding putting custom items into the dockbar the answer is yes. Actually the notifications plugin which comes with the bundle by default is a good example of how to do it.
Publicado el día 29/10/13 7:58 en respuesta a James Falkner.
I was looking at the notifications and wondering how it works. Does it get its content from alerts and announcements, subscriptions, or ... ?
Publicado el día 29/10/13 12:34 en respuesta a Jorge Ferrer.
It shows any notification sent using the notifications API that was introduced in 6.1. This means that it's not limited to Liferay's own portlets, you can use it in yours. Right now, workflow is the only out-of-the-box functionality that uses it, but other features will start using it going forward.
Publicado el día 30/10/13 2:26 en respuesta a Joseph Toman.
Hi @Joseph

I was investigating by myself on the same topic so I'm going to share what I've discovered so far.
Notifications it's a "quite new" portlet plugin that leverage on UserNotificationEvent and UserNotificationEventLocalServiceUtil (a service and an entity included in Liferay Portal). "Quite new" because it seems it was initially developed as a feature included in social office 2.0 and now available in Liferay Portal Bundle.

If you want inspect deeply, source code can be found here: https://github.com/liferay/liferay-plugins/blob/master/portlets/notifications-po­rtlet
Publicado el día 30/10/13 2:37 en respuesta a Joseph Toman.
I like the new dockbar notification implementation, it's like what I did (https://issues.liferay.com/browse/LPS-31082) but better! emoticon
Publicado el día 30/10/13 3:27.
Denis, Jorge, thanks! Is there a portlet or something where users will be able to subscribe to the notifications they want, or more importantly, unsubscribe to the ones they don't? That seems like an essential feature.
Publicado el día 30/10/13 9:22 en respuesta a Jorge Ferrer.
Hey Joseph,

I don't think that exists, because the goal of dockbar notifications where to replace or complement existing email notifications. I can see some value in what you say though. Why don't you create a Feature Request and https://www.liferay.com/community/ideas and promote the idea to check how much interest in this there is?
Publicado el día 30/10/13 10:55 en respuesta a Joseph Toman.
I believe https://issues.liferay.com/browse/LPS-36673 was intended to provide the framework for managing/restricting notifications.
Publicado el día 10/11/13 23:05 en respuesta a Jorge Ferrer.
Very nice work on this for v6.2, folks. A question: how do we remove the "My Sites" dropdown from the dockbar? We're using org sites to allow for org-specific doc library file storage, but want that to be transparent to the user (we're using the merge feature for public pages)
Publicado el día 12/03/14 14:50.
Hey Ben,

As of 6.2, I think the easiest way is with a hook that overwrites the dockbar portlet JSPs. The most specific one you can overwrite is /html/portlet/dockbar/view_my_sites.jspf but since it's a JSPf you will need to either restart the app server or also overwrite the view.jsp to make sure it detects the change.

For future versions we want to learn more about the type of customizations that Liferay users need and make them possible without any development. We had some ideas for 6.2 but didn't have enough feedback to ensure we were choosing the right customization points so we decided to defer it.
Publicado el día 13/03/14 10:32 en respuesta a Ben Uphoff.
Thanks much, Jorge. We also got this clue from the post here https://www.liferay.com/web/jorge.ferrer/blog/-/blogs/new-in-6-2-the-new-dockbar­-

I think we may proceed with this approach. Good stuff - keep up the good work!
Publicado el día 13/03/14 11:44 en respuesta a Jorge Ferrer.
[...] UI/UX Refinements - Too numerous to list here. Responsive themes by default, in-context editing, many Mobile enhancements (including mobile previews), Control Panel awesomeness, a revamped Dockbar... [...] Read More
Publicado el día 15/03/14 1:07.
Anshul Sharma
Hi Jorge , Can you please help me to notify message board notifications in dockbar notifications instead of notify via mails.. Tell me full description how to configure it.
Publicado el día 21/05/14 4:07 en respuesta a Jorge Ferrer.
Hello Jorge!

I have a problem about dockbar in Liferay 6.2 (ee sp3) and I don't know if this is a bug or not.
I create an user with a new role that I have defined with some permissions.
The user has not access to the dockbar on his private layouts, but only on his public layouts.
When I add the role "Power User" to this user, he sees the dockbar on his private layouts, even if I remove all the permissions to "Power User".
Am I obliged to be "Power User" (or "Administrator" I suppose) to get access to the dockbar on private layouts?

Thanking you in advance.
Publicado el día 18/07/14 0:58.
Hey Yamina,

I'm pretty sure that this is a bug that was already fix. Since you seem to have an Enterprise Subscription I would recommend contacting support so that they can tell you in which Fix Pack or Service Pack it is fixed.
Publicado el día 18/07/14 2:22 en respuesta a Yamina AZIZ.
Hi Jorge, you wrote: "since it's a JSPf you will need to either restart the app server or also overwrite the view.jsp to make sure it detects the change" ; also a command like "touch view.jsp" should work on Linux or Mac, or on Windows in gitbash
Publicado el día 21/09/14 17:26 en respuesta a Jorge Ferrer.