Xfce Wiki

Sub domains
 

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Next revision		Previous revision
panel-plugins:xfce4-places-plugin:start [2019/11/09 11:09] – created kevinbowenpanel-plugins:xfce4-places-plugin:start [2025/05/20 15:49] (current) – [Required Packages] Meson andreldm
Line 1: Line 1:
-====== Places ======+~~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]]**
  
-===== About ===== +---- 
-Originally written by [[http://ongardie.net/diego/|Diego Ongaro]], this plugin is a menu with quick access to folders, documents, and removable media. The places plugin brings much of the functionality of GNOME's Places menu to Xfce.+ 
 +===== Introduction =====
  
 The plugin puts a simple button on the panel. Clicking on this button opens up a menu with the following: The plugin puts a simple button on the panel. Clicking on this button opens up a menu with the following:
  
- 1) System-defined directories (home folder, trash, desktop, file system)+  - 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)
  
- 2) Removable media (using thunar-vfs) +----
- +
- 3) User-defined bookmarks (reads ''~/.gtk-bookmarks'') +
- +
- 4) Search program launcher (optional) +
- +
- 5) Recent documents submenu (requires GTK+ v2.10 or greater)+
  
 ===== Usage ===== ===== Usage =====
-Just add it to the panel. 
-User-defined bookmarks can be modified with a file manager or by manually editing ''~/.gtk-bookmarks''. 
-You can configure the plugin by right-clicking on the button and selecting Properties (see screenshot below). 
- 
- 
  
  
 +  - [[: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 ===== ===== Screenshots =====
  
-OK, this first one's not really a screenshot. My friend made this cake to celebrate the 1.0 release (her suggestion). It took some minor damage in transit, then some major damage when I ate it. Good stuff, though. Thanks, Melanie.+<figure "Places Plugin with External Drives connected"> 
 +{{:panel-plugins:places-plugin_panel_indicator_dropdown.png|Places Plugin with External Drives connected}} 
 +</figure>
  
-{{:projects:panel-plugins:xfce4-places-plugin-cake.jpg|:projects:panel-plugins:xfce4-places-plugin-cake.jpg}}+<figure "Places Plugin Right-click Context Menu"> 
 +{{:panel-plugins:places-plugin_panel_right_click_context.png|Places Plugin Right-click Context Menu}} 
 +</figure>
  
-For this screenshot, I plugged in my IPOD:+<figure "Places Plugin 'Recent Documents' Menu"> 
 +{{:panel-plugins:places-plugin_recent_documents.png|Places Plugin 'Recent Documents' Menu}} 
 +</figure>
  
-{{:projects:panel-plugins:xfce4-places-plugin-screen1.png|:projects:panel-plugins:xfce4-places-plugin-screen1.png}}+<figure "Places Plugin Properties/Preferences Dialog Window"> 
 +{{:panel-plugins:places-plugin_preferences.png|Places Plugin Properties/Preferences Dialog Window}} 
 +</figure>
  
-Here, I've clicked on the IPOD menu item and am about to mount it:+[[|Back To Top]] 
 +----
  
-{{:projects:panel-plugins:xfce4-places-plugin-screen3.png|:projects:panel-plugins:xfce4-places-plugin-screen3.png}}+===== Required Packages =====
  
-You can see the recent documents in this screenshot (taken with my IPOD unplugged):+xfce4-places-plugin
  
-{{:projects:panel-plugins:xfce4-places-plugin-screen2.png|:projects:panel-plugins:xfce4-places-plugin-screen2.png}}+  * [[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]]
  
-Here's what it looks like when configured to display a label:+For concrete information on the minimum required versions, check [[https://gitlab.xfce.org/panel-plugins/xfce4-places-plugin/-/blob/master/meson.build|meson.build]]
  
-{{:projects:panel-plugins:xfce4-places-plugin-screen4.png|:projects:panel-plugins:xfce4-places-plugin-screen4.png}}+----
  
-The search program launcher looks like this:+===== Latest Release =====
  
-{{:projects:panel-plugins:xfce4-places-plugin-search.png|:projects:panel-plugins:xfce4-places-plugin-search.png}}+{{rss>https://archive.xfce.org/feeds/project/xfce4-places-plugin 1 date 2h}}
  
-And the properties/preferences dialog:+[[https://gitlab.xfce.org/panel-plugins/xfce4-places-plugin/-/blob/master/NEWS|Read the CHANGELOG]]
  
-{{:projects:panel-plugins:xfce4-places-plugin-prefs.png|:projects:panel-plugins:xfce4-places-plugin-prefs.png}}+  * **[[https://archive.xfce.org/src/panel-plugins/xfce4-places-plugin/|Download current release]]** (older versions of this component are also available here)
  
-===== Releases =====+[[|Back to Top]]
  
-==== Version 1.2 ==== +----
-  * Updates a ton of translations (thanks to the i18n team) +
-  * Adds XDG user dirs support (thanks to Andea Santilli, bug #4461) +
-  * Uses XDG icon names (thanks to Yves-Alexis Perez, bug #5034) +
-  * Shows "Eject" option on removable volumes when Thunar 1.0 does (bug #4136) +
-  * Makes the properties dialog non-modal +
-  * Honors GTK's menu icon size (bug #4744) +
-  * Calls the file browser through exo instead of directly opening Thunar (thanks to Christian Dywan, bug #4463) +
-  * Fixes some issues on shutdown +
-  * Takes advantage of the panel's menu positioning on Xfce 4.6+
  
-[[http://archive.xfce.org/src/panel-plugins/xfce4-places-plugin/1.2/xfce4-places-plugin-1.2.0.tar.bz2|xfce4-places-plugin-1.2.0.tar.bz2]]+===== Source Code Repository =====
  
 +[[https://gitlab.xfce.org/panel-plugins/xfce4-places-plugin]]
  
-==== Version 1.1 ==== +----
-  * "xfce4-popup-places" command to open the menu +
-  * Error messages when mounts/unmounts fail +
-  * Grays out panel icon while busy (un)mounting +
-  * Multiple bug fixes and enhancements (see ChangeLog)+
  
-[[http://goodies.xfce.org/releases/xfce4-places-plugin/xfce4-places-plugin-1.1.0.tar.bz2|xfce4-places-plugin-1.1.0.tar.bz2]]+===== Reporting Bugs =====
  
-==== Version 1.0 (final) ==== +  * **[[:panel-plugins:xfce4-places-plugin:bugs|Reporting Bugs]]** -- List of currently open bugs and instructions on how to submit new bug reports
-  * Added "Mount and Open" action for removable media (Bug #3565) +
-  * Fixed make distcheck errors +
-  * Fixed menu "blinking" when ~/.gtk-bookmarks not found +
-  * Fixed always showing "No items found" in recent documents with GTK 2.12 (Bug #3605) +
-  * Adopted menu positioning from notes plugin for improved behavior with floating panels +
-[[http://goodies.xfce.org/releases/xfce4-places-plugin/xfce4-places-plugin-1.0.0.tar.bz2|xfce4-places-plugin-1.0.0.tar.bz2]]+
  
-==== Version 1.0beta2 (v0.9.992) ==== 
-  * Reorganization of GUI code 
-  * Improved plugin sizing algorithm 
-  * "Open" menu item now opens with Thunar, as intended 
-  * Now polls for model changes (e.g., new devices) while menu is open 
-  * Fix bug #3471 (Rightclick action pins autohidden panel) 
- 
-[[http://goodies.xfce.org/releases/xfce4-places-plugin/xfce4-places-plugin-0.9.992.tar.bz2|xfce4-places-plugin-0.9.992.tar.bz2]] 
- 
-==== Version 1.0beta1 (v0.9.991) ==== 
-  * Adds mount/unmount options for volumes (removable media) 
-  * Adds Open Terminal Here option where applicable 
-  * Search for Files with an external application 
-  * The trash icon now shows whether there's anything in the trash 
-  * Large internal clean-up 
-  * Other minor bug fixes 
- 
-[[http://goodies.xfce.org/releases/xfce4-places-plugin/xfce4-places-plugin-0.9.991.tar.bz2|xfce4-places-plugin-0.9.991.tar.bz2]] 
- 
-==== Version 0.3 ==== 
-  * Adds preferences dialog (optionally show a label on the panel) 
-  * Thunar now opens when middle-clicking the button (Bug #3239) 
-  * Bug fixes 
-   * #3237: Places won't compile on Debian testing 
-   * With no .gtk-bookmarks, the menu showed two consecutive separators 
- 
-[[http://goodies.xfce.org/releases/xfce4-places-plugin/xfce4-places-plugin-0.3.0.tar.bz2|xfce4-places-plugin-0.3.0.tar.bz2]] 
- 
-==== Version 0.2 ==== 
-  * Support for volumes (removable media), recent documents 
-  * Now has 35 translations, taken from Thunar and gnome-panel. 
-  * Rewritten view based on xfdesktop's menu and ''.gtk-bookmarks'' parsing based on Thunar's parser 
-  * Many bug fixes 
-    * #3028: Places button activated when dragged away 
-    * #3029: Places ignores orientation-changed 
-    * #3030: Places shows missing menu items 
-    * #3124: Auto-hidden panel hides on plugin activation 
- 
-[[http://goodies.xfce.org/releases/xfce4-places-plugin/xfce4-places-plugin-0.2.0.tar.bz2|xfce4-places-plugin-0.2.0.tar.bz2]] 
- 
-==== Version 0.1 ==== 
-This is the first stable release. 
- 
-  * Adds i18n support 
-  * Fixes URL escaping display issue (#3027) 
-  * Fixes hard-coded Thunar path (#3053) 
- 
-[[http://goodies.xfce.org/releases/xfce4-places-plugin/xfce4-places-plugin-0.1.0.tar.bz2|xfce4-places-plugin-0.1.0.tar.bz2]] 
- 
-===== Dependencies ===== 
-Xfce 4.4 (or 4.3.99) 
- 
-Thunar VFS v0.4 
- 
-GTK v2.6 (v2.10 required for Recent Documents) 
- 
-===== Reporting Bugs ===== 
-Bugs should be reported to the [[http://bugzilla.xfce.org|Xfce bug tracking system]] (classification ''Panel Plugins'', product ''Xfce4-places-plugin'').  
  
-[[http://bugzilla.xfce.org/buglist.cgi?query_format=advanced&product=Xfce4-places-plugin|See all bugs]]+[[|Back To Top]] 
 +---- 
 +[[:xfce:xfce4-panel:start:|Return to xfce4-panel Main Documentation Page]]