Add "Act as Administrator" toggle action

This commit adds an "Act as Administrator" toggle action to the
View menu if kio-admin is installed. The action allows switching
between acting as an admin with root-access or not.

This was already possible in Dolphin when kio-admin is installed by
editing the location bar directly. However this is somewhat
unintuitive and there are no warnings at all about the dangers of
acting as an administrator.

This commit adds a warning dialog when triggering the action. It is
somewhat explicit about the risks because this is in fact very
dangerous.

Furthermore, while acting on a view with administrative privileges,
a bar above the view shows up that contains a warning. The bar can
be closed to stop acting with elevated privileges.

The warning dialog can be disabled and re-enabled from the Dolphin
settings but only if the action is even available.

There is a lot more to be done to further improve this feature both
security-wise as well as when it comes to usability. But
considering that we are already encouraging users to use this
feature without any warnings at all, I feel like now is a good time
to merge this.

This work is part of a project funded through the NGI0 Entrust
Fund, a fund established by NLnet with financial support from the
European Commission's Next Generation Internet programme, under the
aegis of DG Communications Networks, Content and Technology. As
such, please contact me if you plan on doing related work so what
you are doing doesn't collide with work I am being funded to do.

1 files changed, 75 insertions, 0 deletions

diff --git a/src/admin/bar.h b/src/admin/bar.h
new file mode 100644
index 000000000..5399fa669
--- /dev/null
+++ b/src/admin/bar.h
@@ -0,0 +1,75 @@
+/*
+    This file is part of the KDE project
+    SPDX-FileCopyrightText: 2024 Felix Ernst <[email protected]>
+
+    SPDX-License-Identifier: LGPL-2.1-only OR LGPL-3.0-only OR LicenseRef-KDE-Accepted-LGPL
+*/
+
+#ifndef ADMINBAR_H
+#define ADMINBAR_H
+
+#include "animatedheightwidget.h"
+
+class QLabel;
+class QPushButton;
+class QResizeEvent;
+class QToolButton;
+
+namespace Admin
+{
+
+/**
+ * @brief A bar appearing above the view while the user is acting with administrative privileges.
+ *
+ * It contains a warning and allows revoking this administrative mode by closing this bar.
+ */
+class Bar : public AnimatedHeightWidget
+{
+    Q_OBJECT
+
+public:
+    explicit Bar(QWidget *parent);
+
+    /** Used to recolor this bar when this application's color scheme changes. */
+    bool event(QEvent *event) override;
+
+Q_SIGNALS:
+    void activated();
+
+protected:
+    /** Calls updateLabelString() */
+    void resizeEvent(QResizeEvent *resizeEvent) override;
+
+private:
+    /** Recolors this bar based on the current color scheme. */
+    void updateColors();
+
+    /** Decides whether the m_fullLabelString or m_shortLabelString should be used based on available width. */
+    void updateLabelString();
+
+    /** @see AnimatedHeightWidget::preferredHeight() */
+    inline int preferredHeight() const override
+    {
+        return m_preferredHeight;
+    };
+
+private:
+    /** The text on this bar */
+    QLabel *m_label = nullptr;
+    /** Shows a warning about the dangers of acting with administrative privileges. */
+    QToolButton *m_warningButton = nullptr;
+    /** Closes this bar and exits the administrative mode. */
+    QPushButton *m_closeButton = nullptr;
+
+    /** @see updateLabelString() */
+    QString m_fullLabelString;
+    /** @see updateLabelString() */
+    QString m_shortLabelString;
+
+    /** @see preferredHeight() */
+    int m_preferredHeight;
+};
+
+}
+
+#endif //  ADMINBAR_H