konq_popupmenu.cpp Source File

libkonq

 /* This file is part of the KDE project
    Copyright (C) 1998-2008 David Faure <faure@kde.org>
    Copyright (C) 2001 Holger Freyther <freyther@yahoo.com>
 
    This library is free software; you can redistribute it and/or
    modify it under the terms of the GNU Library General Public
    License as published by the Free Software Foundation; either
    version 2 of the License, or (at your option) any later version.
 
    This library is distributed in the hope that it will be useful,
    but WITHOUT ANY WARRANTY; without even the implied warranty of
    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
    Library General Public License for more details.
 
    You should have received a copy of the GNU Library General Public License
    along with this library; see the file COPYING.LIB.  If not, write to
    the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor,
    Boston, MA 02110-1301, USA.
 */
 
 #include "konq_popupmenu.h"
 #include <kfileitemlistproperties.h>
 #include "konq_popupmenuplugin.h"
 #include "konq_popupmenuinformation.h"
 #include "konq_copytomenu.h"
 #include "kfileitemactions.h"
 #include "kfileitemactionplugin.h"
 #include "kabstractfileitemactionplugin.h"
 #include "kpropertiesdialog.h"
 #include "knewmenu.h"
 #include "konq_operations.h"
 
 #include <klocale.h>
 #include <kbookmarkmanager.h>
 #include <kbookmarkdialog.h>
 #include <kdebug.h>
 #include <krun.h>
 #include <kprotocolmanager.h>
 #include <kicon.h>
 #include <kiconloader.h>
 #include <kinputdialog.h>
 #include <kglobalsettings.h>
 #include <kmimetypetrader.h>
 #include <kstandarddirs.h>
 #include <kconfiggroup.h>
 #include <kdesktopfile.h>
 #include <kfileshare.h>
 #include <kauthorized.h>
 #include <kglobal.h>
 #include <kacceleratormanager.h>
 
 #include <QFileInfo>
 
 /*
  Test cases:
   iconview file: background
   iconview file: file (with and without servicemenus)
   iconview file: directory
   iconview remote protocol (e.g. ftp: or fish:)
   iconview trash:/
   sidebar directory tree
   sidebar Devices / Hard Disc
   khtml background
   khtml link
   khtml image (www.kde.org RMB on K logo)
   khtmlimage (same as above, then choose View image, then RMB)
   selected text in khtml
   embedded katepart
   folder on the desktop
   trash link on the desktop
   trashed file or directory
   application .desktop file
  Then the same after uninstalling kdeaddons/konq-plugins (arkplugin in particular)
 */
 
 class KonqPopupMenuPrivate
 {
 public:
     KonqPopupMenuPrivate(KonqPopupMenu* qq, KActionCollection & actions, QWidget* parentWidget)
         : q(qq),
           m_parentWidget(parentWidget),
           m_itemFlags(KParts::BrowserExtension::DefaultPopupItems),
       m_pMenuNew(0),
           m_copyToMenu(parentWidget),
       m_bookmarkManager(0),
           m_actions(actions),
           m_ownActionCollection(static_cast<QWidget *>(0))
     {
     }
 
     ~KonqPopupMenuPrivate()
     {
         qDeleteAll(m_ownActions);
     }
 
     void addNamedAction(const QString& name);
     void addGroup(const QString& name);
     void addPlugins();
     void init(KonqPopupMenu::Flags kpf, KParts::BrowserExtension::PopupFlags itemFlags);
 
     void slotPopupNewDir();
     void slotPopupNewView();
     void slotPopupEmptyTrashBin();
     void slotConfigTrashBin();
     void slotPopupRestoreTrashedItems();
     void slotPopupAddToBookmark();
     void slotPopupMimeType();
     void slotPopupProperties();
     void slotOpenShareFileDialog();
     void slotShowOriginalFile();
 
     KonqPopupMenu* q;
     QWidget* m_parentWidget;
     QString m_urlTitle;
     KParts::BrowserExtension::PopupFlags m_itemFlags;
     KNewFileMenu *m_pMenuNew;
     KUrl m_sViewURL;
     KFileItemListProperties m_popupItemProperties;
     KonqPopupMenuInformation m_popupMenuInfo; // only used by plugins
     KFileItemActions m_menuActions;
     KonqCopyToMenu m_copyToMenu;
     KBookmarkManager* m_bookmarkManager;
     KActionCollection &m_actions;
     KActionCollection m_ownActionCollection; // only used by plugins; KDE5: pass m_ownActions instead
     QList<KAction*> m_ownActions;
     KParts::BrowserExtension::ActionGroupMap m_actionGroups;
 };
 
 
 KonqPopupMenu::KonqPopupMenu(const KFileItemList &items,
                              const KUrl& viewURL,
                              KActionCollection & actions,
                              KNewFileMenu * newMenu,
                              Flags kpf,
                              KParts::BrowserExtension::PopupFlags flags,
                              QWidget * parentWidget,
                              KBookmarkManager *mgr,
                              const KParts::BrowserExtension::ActionGroupMap& actionGroups)
   : QMenu(parentWidget),
     d(new KonqPopupMenuPrivate(this, actions, parentWidget))
 {
     d->m_actionGroups = actionGroups;
     d->m_pMenuNew = newMenu;
     d->m_sViewURL = viewURL;
     d->m_bookmarkManager = mgr;
     d->m_popupItemProperties.setItems(items);
     d->m_menuActions.setParentWidget(parentWidget);
     d->init(kpf, flags);
 
     KAcceleratorManager::manage(this);
 }
 
 void KonqPopupMenuPrivate::addNamedAction(const QString& name)
 {
     QAction* act = m_actions.action(name);
     if (act)
         q->addAction(act);
 }
 
 void KonqPopupMenuPrivate::init(KonqPopupMenu::Flags kpf, KParts::BrowserExtension::PopupFlags flags)
 {
     m_itemFlags = flags;
     q->setFont(KGlobalSettings::menuFont());
 
     Q_ASSERT(m_popupItemProperties.items().count() >= 1);
 
     bool bTrashIncluded = false;
 
     const KFileItemList lstItems = m_popupItemProperties.items();
     KFileItemList::const_iterator it = lstItems.constBegin();
     const KFileItemList::const_iterator kend = lstItems.constEnd();
     for ( ; it != kend; ++it )
     {
         const KUrl url = (*it).url();
         if ( !bTrashIncluded && (
              ( url.protocol() == "trash" && url.path().length() <= 1 ) ) ) {
             bTrashIncluded = true;
         }
     }
 
     const bool isDirectory = m_popupItemProperties.isDirectory();
     const bool sReading = m_popupItemProperties.supportsReading();
     bool sDeleting = (m_itemFlags & KParts::BrowserExtension::NoDeletion) == 0
                      && m_popupItemProperties.supportsDeleting();
     const bool sWriting = m_popupItemProperties.supportsWriting();
     const bool sMoving = sDeleting && m_popupItemProperties.supportsMoving();
     const bool isLocal = m_popupItemProperties.isLocal();
 
     KUrl url = m_sViewURL;
     url.cleanPath();
 
     bool isTrashLink     = false;
     bool isCurrentTrash = false;
     bool currentDir     = false;
     bool isSymLink = false;
     bool isSymLinkInSameDir = false; // true for "ln -s foo bar", false for links to foo/sub or /foo
 
     //check if url is current directory
     if ( lstItems.count() == 1 )
     {
         KFileItem firstPopupItem( lstItems.first() );
         if (firstPopupItem.isLink()) {
             isSymLink = true;
             isSymLinkInSameDir = !firstPopupItem.linkDest().contains('/');
         }
         KUrl firstPopupURL( firstPopupItem.url() );
         firstPopupURL.cleanPath();
         //kDebug(1203) << "View path is " << url.url();
         //kDebug(1203) << "First popup path is " << firstPopupURL.url();
         currentDir = firstPopupURL.equals( url, KUrl::CompareWithoutTrailingSlash );
         if ( firstPopupItem.isDesktopFile() ) {
             KDesktopFile desktopFile( firstPopupItem.localPath() );
             const KConfigGroup cfg = desktopFile.desktopGroup();
             isTrashLink = ( cfg.readEntry("Type") == "Link" && cfg.readEntry("URL") == "trash:/" );
         }
 
         if (isTrashLink) {
             sDeleting = false;
         }
 
         // isCurrentTrash: popup on trash:/ itself, or on the trash.desktop link
         isCurrentTrash = (firstPopupURL.protocol() == "trash" && firstPopupURL.path().length() <= 1)
                          || isTrashLink;
     }
 
     const bool isIntoTrash = (url.protocol() == "trash") && !isCurrentTrash; // trashed file, not trash:/ itself
 
     const bool bIsLink  = (m_itemFlags & KParts::BrowserExtension::IsLink);
 
     //kDebug() << "isLocal=" << isLocal << " url=" << url << " isCurrentTrash=" << isCurrentTrash << " isIntoTrash=" << isIntoTrash << " bTrashIncluded=" << bTrashIncluded;
 
 
     addGroup( "topactions" ); // used e.g. for ShowMenuBar. includes a separator at the end
 
     KAction * act;
 
     KAction *actNewWindow = 0;
 
 #if 0 // TODO in the desktop code itself.
     if (( flags & KParts::BrowserExtension::ShowProperties ) && isOnDesktop &&
         !KAuthorized::authorizeKAction("editable_desktop_icons"))
     {
         flags &= ~KParts::BrowserExtension::ShowProperties; // remove flag
     }
 #endif
 
     // Either 'newview' is in the actions we're given (probably in the tabhandling group)
     // or we need to insert it ourselves (e.g. for the desktop).
     // In the first case, actNewWindow must remain 0.
     if ( ((kpf & KonqPopupMenu::ShowNewWindow) != 0) && sReading )
     {
         const QString openStr = i18n("&Open");
         actNewWindow = new KAction(m_parentWidget /*for status tips*/);
         m_ownActions.append(actNewWindow);
         actNewWindow->setIcon( KIcon("window-new") );
         actNewWindow->setText( openStr );
         QObject::connect(actNewWindow, SIGNAL(triggered()), q, SLOT(slotPopupNewView()));
     }
 
     if ( isDirectory && sWriting && !isCurrentTrash ) // A dir, and we can create things into it
     {
         const bool mkdirRequested = m_itemFlags & KParts::BrowserExtension::ShowCreateDirectory;
         if ( (currentDir || mkdirRequested) && m_pMenuNew ) // Current dir -> add the "new" menu
         {
             // As requested by KNewFileMenu :
             m_pMenuNew->checkUpToDate();
             m_pMenuNew->setPopupFiles(m_popupItemProperties.urlList());
 
             q->addAction( m_pMenuNew );
             q->addSeparator();
         }
         else if (mkdirRequested)
         {
             KAction *actNewDir = new KAction(m_parentWidget);
             m_ownActions.append(actNewDir);
             actNewDir->setIcon( KIcon("folder-new") );
             actNewDir->setText( i18n( "Create &Folder..." ) );
             QObject::connect(actNewDir, SIGNAL(triggered()), q, SLOT(slotPopupNewDir()));
             q->addAction( actNewDir );
             q->addSeparator();
         }
     } else if ( isIntoTrash ) {
         // Trashed item, offer restoring
         act = new KAction(m_parentWidget /*for status tips*/);
         m_ownActions.append(act);
         act->setText( i18n( "&Restore" ) );
         act->setHelpText(i18n("Restores this file or directory, back to the location where it was deleted from initially"));
         QObject::connect(act, SIGNAL(triggered()), q, SLOT(slotPopupRestoreTrashedItems()));
         q->addAction(act);
     }
 
     if (m_itemFlags & KParts::BrowserExtension::ShowNavigationItems)
     {
         if (m_itemFlags & KParts::BrowserExtension::ShowUp)
             addNamedAction( "go_up" );
         addNamedAction( "go_back" );
         addNamedAction( "go_forward" );
         if (m_itemFlags & KParts::BrowserExtension::ShowReload)
             addNamedAction( "reload" );
         q->addSeparator();
     }
 
     if (!currentDir && isSymLink && !isSymLinkInSameDir) {
         // #65151: offer to open the target's parent dir
         act = new KAction(m_parentWidget);
         m_ownActions.append(act);
         act->setText(isDirectory ? i18n("Show Original Directory") : i18n("Show Original File"));
         act->setHelpText(i18n("Opens a new file manager window showing the target of this link, in its parent directory."));
         QObject::connect(act, SIGNAL(triggered()), q, SLOT(slotShowOriginalFile()));
         q->addAction(act);
     }
 
     // "open in new window" is either provided by us, or by the tabhandling group
     if (actNewWindow) {
         q->addAction(actNewWindow);
         q->addSeparator();
     }
     addGroup( "tabhandling" ); // includes a separator at the end
 
     if (m_itemFlags & KParts::BrowserExtension::ShowUrlOperations) {
         if ( !currentDir && sReading ) {
             if ( sDeleting ) {
                 addNamedAction( "cut" );
             }
             addNamedAction( "copy" );
         }
 
         if ( isDirectory && sWriting ) {
             if ( currentDir )
                 addNamedAction( "paste" );
             else
                 addNamedAction( "pasteto" );
         }
     }
     if ( isCurrentTrash )
     {
         act = new KAction(m_parentWidget);
         m_ownActions.append(act);
         act->setIcon( KIcon("trash-empty") );
         act->setText( i18n( "&Empty Trash Bin" ) );
         KConfig trashConfig( "trashrc", KConfig::SimpleConfig);
         act->setEnabled( !trashConfig.group("Status").readEntry( "Empty", true ) );
         QObject::connect(act, SIGNAL(triggered()), q, SLOT(slotPopupEmptyTrashBin()));
         q->addAction(act);
     }
     if ( isCurrentTrash )
     {
     act = new KAction(m_parentWidget);
     m_ownActions.append(act);
     act->setIcon( KIcon("trash-empty") );
     act->setText( i18n( "&Configure Trash Bin" ) );
     QObject::connect(act, SIGNAL(triggered()), q, SLOT(slotConfigTrashBin()));
     q->addAction(act);
     }
 
     // This is used by KHTML, see khtml_popupmenu.rc (copy, selectAll, searchProvider etc.)
     // and by DolphinPart (rename, trash, delete)
     addGroup( "editactions" );
 
     if (m_itemFlags & KParts::BrowserExtension::ShowTextSelectionItems) {
         // OK, we have to stop here.
 
         // Anything else that is provided by the part
         addGroup( "partactions" );
         return;
     }
 
     if ( !isCurrentTrash && !isIntoTrash && (m_itemFlags & KParts::BrowserExtension::ShowBookmark))
     {
         QString caption;
         if (currentDir)
         {
            const bool httpPage = m_sViewURL.protocol().startsWith("http", Qt::CaseInsensitive);
            if (httpPage)
               caption = i18n("&Bookmark This Page");
            else
               caption = i18n("&Bookmark This Location");
         }
         else if (isDirectory)
            caption = i18n("&Bookmark This Folder");
         else if (bIsLink)
            caption = i18n("&Bookmark This Link");
         else
            caption = i18n("&Bookmark This File");
 
         act = new KAction(m_parentWidget);
         m_ownActions.append(act);
         act->setObjectName( QLatin1String("bookmark_add" )); // for unittest
         act->setIcon( KIcon("bookmark-new") );
         act->setText( caption );
         QObject::connect(act, SIGNAL(triggered()), q, SLOT(slotPopupAddToBookmark()));
         if (lstItems.count() > 1)
             act->setEnabled(false);
         if (KAuthorized::authorizeKAction("bookmarks"))
             q->addAction( act );
         if (bIsLink)
             addGroup( "linkactions" ); // see khtml
     }
 
     // "Open With" actions
 
     m_menuActions.setItemListProperties(m_popupItemProperties);
 
     if ( sReading ) {
         m_menuActions.addOpenWithActionsTo(q, "DesktopEntryName != 'kfmclient' and DesktopEntryName != 'kfmclient_dir' and DesktopEntryName != 'kfmclient_html'");
 
         QList<QAction *> previewActions = m_actionGroups.value("preview");
         if (!previewActions.isEmpty()) {
             if (previewActions.count() == 1) {
                 q->addAction(previewActions.first());
             } else {
                 QMenu* subMenu = new QMenu(i18n("Preview In"), q);
                 subMenu->menuAction()->setObjectName( QLatin1String("preview_submenu" )); // for the unittest
                 q->addMenu(subMenu);
                 subMenu->addActions(previewActions);
             }
         }
     }
 
     // Second block, builtin + user
     m_menuActions.addServiceActionsTo(q);
 
     q->addSeparator();
 
     // Use the Dolphin setting for showing the "Copy To" and "Move To" actions
     KSharedConfig::Ptr dolphin = KSharedConfig::openConfig("dolphinrc");
 
     // CopyTo/MoveTo menus
     if (m_itemFlags & KParts::BrowserExtension::ShowUrlOperations &&
         KConfigGroup(dolphin, "General").readEntry("ShowCopyMoveMenu", false)) {
 
         m_copyToMenu.setItems(lstItems);
         m_copyToMenu.setReadOnly(sMoving == false);
         m_copyToMenu.addActionsTo(q);
         q->addSeparator();
     }
 
     if (!isCurrentTrash && !isIntoTrash && sReading &&
         (kpf & KonqPopupMenu::NoPlugins) == 0) {
         addPlugins(); // now it's time to add plugins
     }
 
     if ( (m_itemFlags & KParts::BrowserExtension::ShowProperties) && KPropertiesDialog::canDisplay( lstItems ) ) {
         act = new KAction(m_parentWidget);
         m_ownActions.append(act);
         act->setObjectName( QLatin1String("properties" )); // for unittest
         act->setText( i18n( "&Properties" ) );
         QObject::connect(act, SIGNAL(triggered()), q, SLOT(slotPopupProperties()));
         q->addAction(act);
     }
 
     while ( !q->actions().isEmpty() &&
             q->actions().last()->isSeparator() )
         delete q->actions().last();
 
     if ( isDirectory && isLocal ) {
         if ( KFileShare::authorization() == KFileShare::Authorized ) {
             q->addSeparator();
             act = new KAction(m_parentWidget);
             m_ownActions.append(act);
             act->setText( i18n("Share") );
             QObject::connect(act, SIGNAL(triggered()), q, SLOT(slotOpenShareFileDialog()));
             q->addAction(act);
         }
     }
 
     // Anything else that is provided by the part
     addGroup( "partactions" );
 }
 
 void KonqPopupMenuPrivate::slotOpenShareFileDialog()
 {
     KPropertiesDialog* dlg = new KPropertiesDialog( m_popupItemProperties.items(), m_parentWidget );
     dlg->showFileSharingPage();
     dlg->exec();
 }
 
 KonqPopupMenu::~KonqPopupMenu()
 {
   delete d;
   //kDebug(1203) << "~KonqPopupMenu leave";
 }
 
 void KonqPopupMenu::setURLTitle( const QString& urlTitle )
 {
     d->m_urlTitle = urlTitle;
 }
 
 KFileItemActions* KonqPopupMenu::fileItemActions() const
 {
     return &(d->m_menuActions);
 }
 
 void KonqPopupMenuPrivate::slotPopupNewView()
 {
     Q_FOREACH(const KUrl& url, m_popupItemProperties.urlList()) {
         (void) new KRun(url, m_parentWidget);
     }
 }
 
 void KonqPopupMenuPrivate::slotPopupNewDir()
 {
   if (m_popupItemProperties.urlList().empty())
     return;
 
   KonqOperations::newDir(m_parentWidget, m_popupItemProperties.urlList().first());
 }
 
 void KonqPopupMenuPrivate::slotPopupEmptyTrashBin()
 {
   KonqOperations::emptyTrash(m_parentWidget);
 }
 
 void KonqPopupMenuPrivate::slotConfigTrashBin()
 {
   KRun::run("kcmshell4 kcmtrash", KUrl::List(), m_parentWidget);
 }
 
 void KonqPopupMenuPrivate::slotPopupRestoreTrashedItems()
 {
   KonqOperations::restoreTrashedItems(m_popupItemProperties.urlList(), m_parentWidget);
 }
 
 void KonqPopupMenuPrivate::slotPopupAddToBookmark()
 {
     KBookmarkGroup root;
     if (m_popupItemProperties.urlList().count() == 1) {
         const KUrl url = m_popupItemProperties.urlList().first();
         const QString title = m_urlTitle.isEmpty() ? url.prettyUrl() : m_urlTitle;
         KBookmarkDialog dlg(m_bookmarkManager, m_parentWidget);
         dlg.addBookmark(title, url.url());
     }
     else
     {
         root = m_bookmarkManager->root();
         Q_FOREACH(const KUrl& url, m_popupItemProperties.urlList()) {
             root.addBookmark(url.prettyUrl(), url);
         }
         m_bookmarkManager->emitChanged(root);
     }
 }
 
 void KonqPopupMenuPrivate::slotPopupMimeType()
 {
     KonqOperations::editMimeType(m_popupItemProperties.mimeType(), m_parentWidget);
 }
 
 void KonqPopupMenuPrivate::slotPopupProperties()
 {
     KPropertiesDialog::showDialog(m_popupItemProperties.items(), m_parentWidget, false);
 }
 
 void KonqPopupMenuPrivate::addGroup(const QString& name)
 {
     QList<QAction *> actions = m_actionGroups.value(name);
     q->addActions(actions);
 }
 
 void KonqPopupMenuPrivate::addPlugins()
 {
     QString commonMimeType = m_popupItemProperties.mimeType();
     if (commonMimeType.isEmpty()) {
         commonMimeType = QLatin1String("application/octet-stream");
     }
     const KService::List konqPlugins = KMimeTypeTrader::self()->query(commonMimeType, "KonqPopupMenu/Plugin", "exist Library");
 
     if (!konqPlugins.isEmpty()) {
         m_popupMenuInfo.setItemListProperties(m_popupItemProperties);
         m_popupMenuInfo.setParentWidget(m_parentWidget);
         KService::List::ConstIterator iterator = konqPlugins.begin();
         const KService::List::ConstIterator end = konqPlugins.end();
         for(; iterator != end; ++iterator) {
             //kDebug() << (*iterator)->name() << (*iterator)->library();
             KonqPopupMenuPlugin *plugin = (*iterator)->createInstance<KonqPopupMenuPlugin>(q);
             if (!plugin)
                 continue;
             plugin->setParent(q);
             plugin->setup(&m_ownActionCollection, m_popupMenuInfo, q);
         }
     }
 
     const KService::List fileItemPlugins = KMimeTypeTrader::self()->query(commonMimeType, "KFileItemAction/Plugin", "exist Library");
     if (!fileItemPlugins.isEmpty()) {
         const KConfig config("kservicemenurc", KConfig::NoGlobals);
         const KConfigGroup showGroup = config.group("Show");
 
         foreach (const KSharedPtr<KService>& service, fileItemPlugins) {
             if (!showGroup.readEntry(service->desktopEntryName(), true)) {
                 // The plugin has been disabled
                 continue;
             }
 
             // Old API (kdelibs-4.6.0 only)
             KFileItemActionPlugin* plugin = service->createInstance<KFileItemActionPlugin>();
             if (plugin) {
                 plugin->setParent(q);
                 q->addActions(plugin->actions(m_popupItemProperties, m_parentWidget));
             }
             // New API (kdelibs >= 4.6.1)
             KAbstractFileItemActionPlugin* abstractPlugin = service->createInstance<KAbstractFileItemActionPlugin>();
             if (abstractPlugin) {
                 abstractPlugin->setParent(q);
                 q->addActions(abstractPlugin->actions(m_popupItemProperties, m_parentWidget));
             }
         }
     }
 }
 
 void KonqPopupMenuPrivate::slotShowOriginalFile()
 {
     const KFileItem item = m_popupItemProperties.items().first();
     const QString dest = item.linkDest();
     KUrl destUrl = m_sViewURL;
     if (dest.startsWith('/')) {
         destUrl.setPath(dest);
     } else {
         destUrl.addPath(dest);
     }
     // Now destUrl points to the target file, let's go up to parent dir
     destUrl.setPath(destUrl.directory());
     KRun::runUrl(destUrl, "inode/directory", m_parentWidget);
 }
 
 #include "konq_popupmenu.moc"
KDE's Doxygen guidelines are available online.
libkonq

libkonq

kde-baseapps API Reference

Search
