~~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 =====


  - [[:xfce:xfce4-panel:add-new-items|Add the plugin to the panel]].
  - Right-click on the added plugin, select **Properties** to open the settings window. 

After adding the plugin to the panel, user-defined bookmarks can be modified with a file manager or by manually editing ''~/.gtk-bookmarks''.

----

===== Screenshots =====

<figure "Places Plugin with External Drives connected">
{{:panel-plugins:places-plugin_panel_indicator_dropdown.png|Places Plugin with External Drives connected}}
</figure>

<figure "Places Plugin Right-click Context Menu">
{{:panel-plugins:places-plugin_panel_right_click_context.png|Places Plugin Right-click Context Menu}}
</figure>

<figure "Places Plugin 'Recent Documents' Menu">
{{:panel-plugins:places-plugin_recent_documents.png|Places Plugin 'Recent Documents' Menu}}
</figure>

<figure "Places Plugin Properties/Preferences Dialog Window">
{{:panel-plugins:places-plugin_preferences.png|Places Plugin Properties/Preferences Dialog Window}}
</figure>

[[|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]]** (older versions of this component are also available here)

[[|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]]** -- List of currently open bugs and instructions on how to submit new bug reports


[[|Back To Top]]
----
[[:xfce:xfce4-panel:start:|Return to xfce4-panel Main Documentation Page]]