+void DolphinMainWindow::setupWhatsThis()
+{
+ // main widgets
+ menuBar()->setWhatsThis(xi18nc("@info:whatsthis", "<para>This is the "
+ "<emphasis>Menubar</emphasis>. It provides access to commands and "
+ "configuration options. Left-click on any of the menus on this "
+ "bar to see its contents.</para><para>The Menubar can be hidden "
+ "by unchecking <interface>Settings|Show Menubar</interface>. Then "
+ "most of its contents become available through a <interface>Control"
+ "</interface> button on the <emphasis>Toolbar</emphasis>.</para>"));
+ toolBar()->setWhatsThis(xi18nc("@info:whatsthis", "<para>This is the "
+ "<emphasis>Toolbar</emphasis>. It allows quick access to "
+ "frequently used actions.</para><para>It is highly customizable. "
+ "All items you see in the <interface>Control</interface> menu or "
+ "in the <interface>Menubar</interface> can be placed on the "
+ "Toolbar. Just right-click on it and select <interface>Configure "
+ "Toolbars…</interface> or find this action in the <interface>"
+ "Control</interface> or <interface>Settings</interface> menu."
+ "</para><para>The location of the bar and the style of its "
+ "buttons can also be changed in the right-click menu. Right-click "
+ "a button if you want to show or hide its text.</para>"));
+ m_tabWidget->setWhatsThis(xi18nc("@info:whatsthis main view",
+ "<para>Here you can see the <emphasis>folders</emphasis> and "
+ "<emphasis>files</emphasis> that are at the location described in "
+ "the <interface>Location Bar</interface> above. This area is the "
+ "central part of this application where you navigate to the files "
+ "you want to use.</para><para>For an elaborate and general "
+ "introduction to this application <link "
+ "url='https://userbase.kde.org/Dolphin/File_Management#Introduction_to_Dolphin'>"
+ "click here</link>. This will open an introductory article from "
+ "the <emphasis>KDE UserBase Wiki</emphasis>.</para><para>For brief "
+ "explanations of all the features of this <emphasis>view</emphasis> "
+ "<link url='help:/dolphin/dolphin-view.html'>click here</link> "
+ "instead. This will open a page from the <emphasis>Handbook"
+ "</emphasis> that covers the basics.</para>"));
+
+ // Settings menu
+ actionCollection()->action(KStandardAction::name(KStandardAction::KeyBindings))
+ ->setWhatsThis(xi18nc("@info:whatsthis","<para>This opens a window "
+ "that lists the <emphasis>keyboard shortcuts</emphasis>.<nl/>"
+ "There you can set up key combinations to trigger an action when "
+ "they are pressed simultaneously. All commands in this application can "
+ "be triggered this way.</para>"));
+ actionCollection()->action(KStandardAction::name(KStandardAction::ConfigureToolbars))
+ ->setWhatsThis(xi18nc("@info:whatsthis","<para>This opens a window in which "
+ "you can change which buttons appear on the <emphasis>Toolbar</emphasis>.</para>"
+ "<para>All items you see in the <interface>Control</interface> menu "
+ "or in the <interface>Menubar</interface> can also be placed on the Toolbar.</para>"));
+ actionCollection()->action(KStandardAction::name(KStandardAction::Preferences))
+ ->setWhatsThis(xi18nc("@info:whatsthis","This opens a window where you can "
+ "change a multitude of settings for this application. For an explanation "
+ "of the various settings go to the chapter <emphasis>Configuring Dolphin"
+ "</emphasis> in <interface>Help|Dolphin Handbook</interface>."));
+
+ // Help menu
+ // The whatsthis has to be set for the m_helpMenu and for the
+ // StandardAction separately because both are used in different locations.
+ // m_helpMenu is only used for createControlButton() button.
+
+ // Links do not work within the Menubar so texts without links are provided there.
+
+ // i18n: If the external link isn't available in your language you should
+ // probably state the external link language at least in brackets to not
+ // frustrate the user. If there are multiple languages that the user might
+ // know with a reasonable chance you might want to have 2 external links.
+ // The same is in my opinion true for every external link you translate.
+ const QString whatsThisHelpContents = xi18nc("@info:whatsthis handbook",
+ "<para>This opens the Handbook for this application. It provides "
+ "explanations for every part of <emphasis>Dolphin</emphasis>.</para>");
+ actionCollection()->action(KStandardAction::name(KStandardAction::HelpContents))
+ ->setWhatsThis(whatsThisHelpContents
+ + xi18nc("@info:whatsthis second half of handbook hb text without link",
+ "<para>If you want more elaborate introductions to the "
+ "different features of <emphasis>Dolphin</emphasis> "
+ "go to the KDE UserBase Wiki.</para>"));
+ m_helpMenu->action(KHelpMenu::menuHelpContents)->setWhatsThis(whatsThisHelpContents
+ + xi18nc("@info:whatsthis second half of handbook text with link",
+ "<para>If you want more elaborate introductions to the "
+ "different features of <emphasis>Dolphin</emphasis> "
+ "<link url='https://userbase.kde.org/Dolphin/File_Management'>click here</link>. "
+ "It will open the dedicated page in the KDE UserBase Wiki.</para>"));
+
+ const QString whatsThisWhatsThis = xi18nc("@info:whatsthis whatsthis button",
+ "<para>This is the button that invokes the help feature you are "
+ "using right now! Click it, then click any component of this "
+ "application to ask \"What's this?\" about it. The mouse cursor "
+ "will change appearance if no help is available for a spot.</para>");
+ actionCollection()->action(KStandardAction::name(KStandardAction::WhatsThis))
+ ->setWhatsThis(whatsThisWhatsThis
+ + xi18nc("@info:whatsthis second half of whatsthis button text without link",
+ "<para>There are two other ways to get help for this application: The "
+ "<interface>Dolphin Handbook</interface> in the <interface>Help"
+ "</interface> menu and the <emphasis>KDE UserBase Wiki</emphasis> "
+ "article about <emphasis>File Management</emphasis> online."
+ "</para><para>The \"What's this?\" help is "
+ "missing in most other windows so don't get too used to this.</para>"));
+ m_helpMenu->action(KHelpMenu::menuWhatsThis)->setWhatsThis(whatsThisWhatsThis
+ + xi18nc("@info:whatsthis second half of whatsthis button text with link",
+ "<para>There are two other ways to get help: "
+ "The <link url='help:/dolphin/index.html'>Dolphin Handbook</link> and "
+ "the <link url='https://userbase.kde.org/Dolphin/File_Management'>KDE "
+ "UserBase Wiki</link>.</para><para>The \"What's this?\" help is "
+ "missing in most other windows so don't get too used to this.</para>"));
+
+ const QString whatsThisReportBug = xi18nc("@info:whatsthis","<para>This opens a "
+ "window that will guide you through reporting errors or flaws "
+ "in this application or in other KDE software.</para>");
+ actionCollection()->action(KStandardAction::name(KStandardAction::ReportBug))
+ ->setWhatsThis(whatsThisReportBug);
+ m_helpMenu->action(KHelpMenu::menuReportBug)->setWhatsThis(whatsThisReportBug
+ + xi18nc("@info:whatsthis second half of reportbug text with link",
+ "<para>High-quality bug reports are much appreciated. To learn "
+ "how to make your bug report as effective as possible "
+ "<link url='https://community.kde.org/Get_Involved/Bug_Reporting'>"
+ "click here</link>.</para>"));
+
+ const QString whatsThisDonate = xi18nc("@info:whatsthis","<para>This opens a "
+ "<emphasis>web page</emphasis> where you can donate to "
+ "support the continued work on this application and many "
+ "other projects by the <emphasis>KDE</emphasis> community.</para>"
+ "<para>Donating is the easiest and fastest way to efficiently "
+ "support KDE and its projects. KDE projects are available for "
+ "free therefore your donation is needed to cover things that "
+ "require money like servers, contributor meetings, etc.</para>"
+ "<para><emphasis>KDE e.V.</emphasis> is the non-profit "
+ "organization behind the KDE community.</para>");
+ actionCollection()->action(KStandardAction::name(KStandardAction::Donate))
+ ->setWhatsThis(whatsThisDonate);
+ m_helpMenu->action(KHelpMenu::menuDonate)->setWhatsThis(whatsThisDonate);
+
+ const QString whatsThisSwitchLanguage = xi18nc("@info:whatsthis",
+ "With this you can change the language this application uses."
+ "<nl/>You can even set secondary languages which will be used "
+ "if texts are not available in your preferred language.");
+ actionCollection()->action(KStandardAction::name(KStandardAction::SwitchApplicationLanguage))
+ ->setWhatsThis(whatsThisSwitchLanguage);
+ m_helpMenu->action(KHelpMenu::menuSwitchLanguage)->setWhatsThis(whatsThisSwitchLanguage);
+
+ const QString whatsThisAboutApp = xi18nc("@info:whatsthis","This opens a "
+ "window that informs you about the version, license, "
+ "used libraries and maintainers of this application.");
+ actionCollection()->action(KStandardAction::name(KStandardAction::AboutApp))
+ ->setWhatsThis(whatsThisAboutApp);
+ m_helpMenu->action(KHelpMenu::menuAboutApp)->setWhatsThis(whatsThisAboutApp);
+
+ const QString whatsThisAboutKDE = xi18nc("@info:whatsthis","This opens a "
+ "window with information about <emphasis>KDE</emphasis>. "
+ "The KDE community are the people behind this free software."
+ "<nl/>If you like using this application but don't know "
+ "about KDE or want to see a cute dragon have a look!");
+ actionCollection()->action(KStandardAction::name(KStandardAction::AboutKDE))
+ ->setWhatsThis(whatsThisAboutKDE);
+ m_helpMenu->action(KHelpMenu::menuAboutKDE)->setWhatsThis(whatsThisAboutKDE);
+}
+
+bool DolphinMainWindow::event(QEvent *event)
+{
+ if (event->type() == QEvent::WhatsThisClicked) {
+ event->accept();
+ QWhatsThisClickedEvent* whatsThisEvent = dynamic_cast<QWhatsThisClickedEvent*>(event);
+ QDesktopServices::openUrl(QUrl(whatsThisEvent->href()));
+ return true;
+ } else if (event->type() == QEvent::WindowActivate) {
+ updateOpenPreferredSearchToolAction();
+ }
+ return KXmlGuiWindow::event(event);
+}
+
+bool DolphinMainWindow::eventFilter(QObject* obj, QEvent* event)
+{
+ Q_UNUSED(obj)
+ if (event->type() == QEvent::WhatsThisClicked) {
+ event->accept();
+ QWhatsThisClickedEvent* whatsThisEvent = dynamic_cast<QWhatsThisClickedEvent*>(event);
+ QDesktopServices::openUrl(QUrl(whatsThisEvent->href()));
+ return true;
+ }
+ return false;
+}
+
+void DolphinMainWindow::focusTerminalPanel()
+{
+ if (m_terminalPanel->isVisible()) {
+ if (m_terminalPanel->terminalHasFocus()) {
+ m_activeViewContainer->view()->setFocus(Qt::FocusReason::ShortcutFocusReason);
+ actionCollection()->action(QStringLiteral("focus_terminal_panel"))->setText(i18nc("@action:inmenu Tools", "Focus Terminal Panel"));
+ } else {
+ m_terminalPanel->setFocus(Qt::FocusReason::ShortcutFocusReason);
+ actionCollection()->action(QStringLiteral("focus_terminal_panel"))->setText(i18nc("@action:inmenu Tools", "Defocus Terminal Panel"));
+ }
+ } else {
+ actionCollection()->action(QStringLiteral("show_terminal_panel"))->trigger();
+ actionCollection()->action(QStringLiteral("focus_terminal_panel"))->setText(i18nc("@action:inmenu Tools", "Defocus Terminal Panel"));
+ }
+}
+