~~NOTOC~~
====== xfce4-places-plugin - Places ======

A menu with quick access to folders, documents, and removable media.

  * **[[#Screenshots|Screenshots]]**
  * **[[#Required Packages|Required Packages]]**
  * **[[#Latest Release|Latest Release]]**
  * **[[#Release History|Release History]]**
  * **[[#Source Code Repository|Source Code Repository]]**
  * **[[#Reporting Bugs|Reporting Bugs]]**

----

===== Introduction =====

The plugin puts a simple button on the panel. Clicking on this button opens up a menu with the following:

  - System-defined directories (home folder, trash, desktop, file system)
  - Removable media (using thunar-vfs)
  - User-defined bookmarks (reads ''~/.gtk-bookmarks'')
  - Search program launcher (optional)
  - Recent documents submenu (requires GTK+ v2.10 or greater)

----

===== Usage =====

After adding the plugin to the panel, user-defined bookmarks can be modified with a file manager or by manually editing ''~/.gtk-bookmarks''.
The plugin can be configured by right-clicking on the button and selecting Properties (see screenshot below).

----

===== Screenshots =====


For this screenshot, I plugged in my IPOD:

{{:panel-plugins:xfce4-places-plugin-screen1.png|:panel-plugins:xfce4-places-plugin-screen1.png}}

Here, I've clicked on the IPOD menu item and am about to mount it:

{{:panel-plugins:xfce4-places-plugin-screen3.png|:panel-plugins:xfce4-places-plugin-screen3.png}}

You can see the recent documents in this screenshot (taken with my IPOD unplugged):

{{:panel-plugins:xfce4-places-plugin-screen2.png|:panel-plugins:xfce4-places-plugin-screen2.png}}

Here's what it looks like when configured to display a label:

{{:panel-plugins:xfce4-places-plugin-screen4.png|:panel-plugins:xfce4-places-plugin-screen4.png}}

The search program launcher looks like this:

{{:panel-plugins:xfce4-places-plugin-search.png|:panel-plugins:xfce4-places-plugin-search.png}}

And the properties/preferences dialog:

{{:panel-plugins:xfce4-places-plugin-prefs.png|:panel-plugins:xfce4-places-plugin-prefs.png}}

[[|Back To Top]]
----

===== Required Packages =====

xfce4-places-plugin

  * [[https://developer.gnome.org/gio/|GIO]]
  * [[https://wiki.gnome.org/Projects/GLib|GLib]]
  * [[https://www.gtk.org|GTK+]]
  * gmodule-2.0
  * gobject-2.0
  * gthread-2.0
  * [[https://gitlab.xfce.org/xfce/libxfce4ui|libxfce4ui]]
  * [[https://gitlab.xfce.org/xfce/libxfce4util|libxfce4util]]
  * [[https://gitlab.xfce.org/xfce/xfce4-panel|xfce4-panel]]
  * [[https://gitlab.xfce.org/xfce/exo|exo]]
  * [[https://gitlab.xfce.org/xfce/xfconf|xfconf]]

For concrete information on the minimum required versions, check [[https://gitlab.xfce.org/panel-plugins/xfce4-places-plugin/-/blob/master/configure.ac.in|configure.ac.in]]

----

===== Latest Release =====

{{rss>https://archive.xfce.org/feeds/project/xfce4-places-plugin 1 date 2h}}

[[https://gitlab.xfce.org/panel-plugins/xfce4-places-plugin/-/blob/master/NEWS|Read the CHANGELOG]]

  * **[[https://archive.xfce.org/src/panel-plugins/xfce4-places-plugin/|Download current release]]** (link also contains older versions)

[[|Back to Top]]

----

===== Source Code Repository =====

[[https://gitlab.xfce.org/panel-plugins/xfce4-places-plugin]]

----

===== Reporting Bugs =====

  * **[[:panel-plugins:xfce4-places-plugin:bugs|Reporting Bugs]]** -- Open bug reports and how to report new bugs


[[|Back To Top]]
----
[[ :xfce:xfce4-panel:start:|Return to Main Xfce4-panel page]]