Monday, August 18, 2008

Configuring the Plasma Panel

I had several papers to write last night and found myself looking for excuses not to write them. I eventually ended up reflecting on how I felt about writing documentation and to be honest, it isn't something I enjoy. In fact, the two things I hate the most about writing applications are: 1) writing documentation, and 2) writing configuration dialogs, but the second issue is out of the scope of this entry. ;) I suppose my objections to writing documentation stem from my opinion that they waste my time. I could be better off doing something more productive like writing new code (or perhaps playing sudoku :D). A program should be self-explanatory to the point that a user can understand what to do without having to read documentation. Nevertheless, I never really exerted effort in writing documentation so I decided I'd give it a try. (Please spare me the flames in case I do poorly. You have been warned.)

One area that could use improvements in documentation is configuring panels in Plasma. Sebas did a good job but he only dedicated one paragraph to it in the documentation and it didn't have any pretty pictures. Most people react to visuals more so I decided to supplement the documentation.


Configuring the Panel

Figure 1 The Default Panel

Similar to the panel layout in previous KDE versions, the default panel configuration consists of: 1) an application launcher button, 2) a device notifier button, 3) a pager, 4) the task manager, 5) the system tray, and 6) the system clock. By default, the panel takes up the entire width of your screen.

The application launcher defaults to the Kickoff menu style. If you prefer a traditional hierarchical menu, right click on the application launcher and select "Switch to Classic Menu Style". (Figure 2)

Figure 2 Switch to traditional launch menu

The panel may be configured by clicking on the plasma logo, (commonly referred to as the "cashew") at the right-most end of the panel. If the cashew is not visible, right click anywhere on the panel or desktop and select "Unlock Widgets". Alternatively, you can unlock the widgets by pressing Ctrl-L when there are no active windows.

Figure 3 Unlocking Widgets

Clicking on the plasma logo opens up the panel settings window just above the panel. (Figure 4)

Figure 4 Panel Settings Window

This window allows users to configure the position, alignment and size of the panels. The window also allows repositioning of plasmoids within the panel.

Changing Panel Alignment, Position and Size

The panel may be configured to be anchored to the left side of the screen, the center of the screen, or the right side of the screen depending on your preferences. Simply select the desired alignment by clicking on the appropriate button in the panel settings window. (Figure 5)

Figure 5 Panel Alignment Buttons

At the bottom of the panel settings window there are slider handles of three different colors. The gray slider handle dictates the offset from the current panel anchor point. For left-aligned panels, moving the gray slider will move the beginning of the panel a fixed distance to the right of the left edge of the screen. For right-aligned panels, the panel will be moved a fixed distance from the right edge of the screen. For center-aligned panels, the position of the gray slider handle will be treated as the center of the panel.

Plasma supports dynamically adjusting panels that grow based on the contents of the panels. The green slider handles specify the minimum panel width. The panel is guaranteed to be at least as wide as specified by these slider handles even as the contents of the panel decrease. On the other hand, the blue slider handles control the maximum width of the panel. The panel size will not grow beyond the points specified by the blue slider handles. Panel growth is dependent on alignment of the panel. Left-aligned panels will only grow towards the right edge of the screen. Similarly, right-aligned panels only grow towards the left edge of the screen. Center-aligned panels grow towards both edges of the screen. Figures 6 and 7 illustrate the growth of the panel after the addition of a widget.

Figure 6 Panel Size is at Minimum

Figure 7 Panel Growth after adding Widget

The panel height can also be changed by dragging the topmost portion of the panel settings window until the desired panel height is reached. Widgets will automatically resize themselves based on this new height. (Figure 8)

Figure 8 New Panel height

Adding Widgets

Additional widgets can be added to the panel to provide more functionality. New widgets can be added by clicking on the Add Widgets button in the panel settings window. Alternatively, right clicking anywhere on the panel and selecting "Add Widgets..." will also open the Add Widgets dialog box. (Figure 9)

Figure 9 Add Widgets dialog box

Widgets can be added to the panel by double-clicking on the desired widget or selecting the widget and clicking on "Add Widget". By default, the widget is placed at the right-most end of the panel. (Figure 10)
Figure 10 Position of Newly Added Widget

If a specific position is desired, a new widget can instead be positioned by dragging it to its desired location from the Add Widget dialog box.

Changing Widget Positions

In some cases, you may want to change the position of a widget. To do this, open the panel settings window and hover the mouse over the widget you wish to move. A move emblem will be placed over the center of this widget. (Figure 11)

Figure 11 Move Emblem over Widget

Select the widget by clicking on it. This will highlight the background of the widget. (Figure 12)

Figure 12 Selection of Widget to Move

Move the mouse over the desired position. Plasma will highlight the new position of the widget. (Figure 13)

Figure 13 Selection of New position

Left click on the widget to finalize its new position.


Suayip OZMEN said...

i used kde4.1 on opensuse. but i dont like. because i couldnt change panels like only task manager at buttom. at top of the desktop left corner a start button. near a desktop switcher. and center some shurtcuts of programs. at the right system tray and clock. but problem is system tray grows and it expands to all bar. how chan i give it a prefered size. sample image from my kde3

Joro said...

It is related to this bug

mart said...

Good post!
maybe in 4.2 it will be a bit different, buti think this thing would be cool to go in an official user guide/documentation :)

suayip ozmen: there is a systray refactor about to be merged that will permit to hide icons again, this should in part solve the problem

Marcel said...

how can I move the panel to the top?

dilettante said...

@marcel: Yes you can. While the panel settings window is open drag the panel settings window upward until the panel shifts to the top of your screen. Thanks for asking. I forgot to add it here.

[Knuckles] said...

To move the panel, click the "cashew" on the panel (the plasma thingy), and drag the panel settings bar that opens above the panel to where you want it.

seajey said...

>and drag the panel settings bar that opens above the panel to where you want it.

Are you sure?
In my case if i do such a thing panel will only grow in height.

madfire said...

Thanks! This is the kind of docs I like - explaining visually some bits, which turn out to be obvious but still obscure (like dragging the widgets straight from the add widget dialog).
I've been planning to do such docs for skype myself for a long time, but see first paragraph of your post :)

TonyM said...

You missed two actions, which have been touched on in the previous comments. These are the two least obvious actions, so the most important to document.

Moving the panel to a different position or screen: simply open the panel controller and drag it (by clicking on empty space in the controller) to another position or screen.

Resizing the panel thickness: Open the panel controller, click on the top bar of the controller and drag to change the thickness of the panel.

dilettante said...

@tonym: Height = Thickness. It's the last paragraph under "Changing Panel Alignment, Position, and Size". But yes I did miss dragging the panel.

Artstudio Sri Lanka said...

For quality LCD and Plasma TV Wall Mounts, Brackets and Stands for all the top brands you can check out.

They are great!

Xycris said...

How do I autohide the entire task bar in KDE 4.1? It takes up space when working full screen on the desktop.

Abe Nonymous said...

I am way late to this post... I am trying to figure out how to make the panel the width of the screen without having to drag the slider over there. My problem is that I login remotely from a smaller screen, and when I get back to the larger screen the panel has shrunk down to the size of the smaller monitor. It's very annoying to have to resize it every single time I get home. Is there a way to force it to be screen-width?