Die Erweiterung des umbraco Armaturenbrett

Question

Ich mag meinen eigenen Abschnitt zum umbraco Dashboard hinzufügen, so dass ich mein eigenes Admin-Stück auf die bestehenden Login / admin Struktur integrieren. Ist dies möglich, ohne dass die Bearbeitung und neu zu kompilieren die umbraco Quelle selbst? Ist es zu empfehlen? Wenn ja, ist Ressourcen jemand muss diese ersten Schritte zu tun?

Answer 1

Ja, das ist möglich.

Das Backend kann sowohl in Bezug auf den dashoard, Abschnitte und Inhalt Bäume erweitert werden.

Es gibt eine Konfigurationsdatei, die Sie neue Dashboard Abschnitte definieren können. Die Konfigurationsdatei kann in folgendem Ordner zu finden: /config/dashboard.config

Normalerweise wird die dashboard.config Datei hat einige Beispiel XML, wie es muss strukturiert werden, die etwa wie folgt aussieht (ich habe es ein wenig erweitert mehrere der Merkmale zeigen).

<dashBoard>
    <section>
        <areas>
            <area>default</area>
            <area>content</area>
            <area>member</area>
        </areas>

        <tab caption="Last Edits">
            <control>/usercontrols/dashboard/latestEdits.ascx</control>
        </tab>
        <tab caption="Latest Items">
            <control>/usercontrols/dashboard/newestItems.ascx</control>
        </tab>
        <tab caption="Create blog post">
            <control>/usercontrols/umbracoBlog/dashboardBlogPostCreate.ascx</control>
        </tab>
    </section>
    <section>
        <areas>
            <area>media</area>
        </areas>

        <tab caption="Last Edits">
            <control>/usercontrols/dashboard/latestEdits.ascx</control>
        </tab>
    </section>
</dashBoard>

Der Abschnitt Knoten können Sie verschiedene Register Gruppen für verschiedene Server-Betreiber Abschnitte einzurichten. In dem obigen Beispiel dem Registerkarten Neueste redigiert, Neuester Artikel und Blog-Beitrag erstellen wird auf den Standard, Mitglied und Inhalt Abschnitte angewandt werden. Defaut ist das erste, was der Benutzer sieht, wenn sie in die Back-End-Anmeldung vor einem Abschnitt auswählen.

Um zu steuern, was in den verschiedenen Abschnitten zu sehen ist, setzen Sie einen neuen Abschnitt Knoten und definieren, welchen Bereich sie gilt und die Registerkarte zu zeigen. In dem obigen Beispiel dem zweiten Abschnitt gilt nur für den Media-Bereich.

Was in der Registerkarte angezeigt wird, ist eine normale .NET Benutzersteuerung. Dies kann völlig getrennt von Umbraco oder umbraco spezifischen Code enthalten können, je nachdem, ob Sie eine Legacy-Anwendung integrieren oder einfach erstreckt umbraco.

Wenn Sie einen neuen Abschnitt (eines der Symbole, die in der unteren linken Ecke des umbraco Backend erscheint) erstellen, dann werden Sie Ihre Hände ein wenig dreckigen bekommen müssen.

Um einen Abschnitt hinzufügen, müssen Sie ein paar Datenbankeinträge hinzuzufügen. Zuerst müssen Sie die App in der umbracoApp Tabelle definieren.

Dann einen Eintrag umbracoUsers2App für den Admin-Benutzer hinzufügen (0).

Sie werden dann brauchen einen neuen Inhaltsbaum und erstellen die unterstützenden Bedienelemente zu definieren.

Es gibt mehr Informationen über diese hier einrichten: http://www.geckonewmedia.com/blog/2009/8/3/how-to-create-a-custom-section-in-umbraco-4

Der erste Ansatz (nur einige neue Registerkarten definieren) ist wesentlich einfacher, als einen neuen Abschnitt hinzugefügt, also würde ich empfehlen Sie damit anfangen. Dann, wenn Sie bequemer sind, können Sie rechts in tauchen und ganz neue Abschnitte und Inhalt Bäume erstellen!

Answer 2

Wow! 7 Jahre alt Beitrag oben noch auf Google-Suche.

So lässt Update die Antwort:

Hier können Sie die Dokumentation für die Erweiterung von Dashboards finden: Armaturenbretter

Armaturenbrett

Wie bei den anderen CONFIG-Dateien im Verzeichnis / config die Dashboard.config Datei können Sie einen Teil der Umbraco Erfahrung anpassen. In diesem Fall steuert die Dashboard.config Datei, was im Dashboard Abschnitt der Benutzeroberfläche zeigt sich, wenn ein Teil der Seite lädt. Das Dashboard ist der Bereich auf der rechten Seite der Benutzeroberfläche, wo die meisten der Dateneingabe und funktionelle Interaktion stattfindet.

In der Standardeinstellung Umbraco ein leeres Armaturenbrett zeigt, wenn ein neuer Abschnitt Last und nur eine Form zeigt, wenn Sie Maßnahmen ergreifen, im Abschnitt (dh, wenn Sie auf einem Knoten klicken Sie im Abschnitt Inhalt zeigt das Dashboard die Form, dass Knotens zu aktualisieren Daten). Aber was, wenn Sie Ihre UI-Benutzer mit einigen Optionen präsentieren wollten, noch bevor sie auf einem Knoten klicken? Nun, das ist es, was die Dashboard.config ermöglicht es Ihnen, zu tun.

Layout

Wie die anderen CONFIG-Dateien Dashboard.config ist eine einfache XML-Datei mit einem ziemlich straight-forward-Layout wie unten zu sehen.

<?xml version="1.0" encoding="utf-8" ?> 
<dashBoard> <!-- root of the dashboard xml tree -->
   <section>  <!-- defines a dashboard layout for a group of sections -->
        <areas> <!-- Declares which sections (i.e. content,media,users,[your own]-->
            <area>[area name]</area> <!-- A section to apply this to -->
            ...
        </areas>

        <tab caption="[caption]"> <!-- Creates a tab in the Dashboard with the assigned Caption -->
            <control>[path]</control> <!-- What control to load in that tab -->
        </tab>
        ...
   </section>
   ...
</dashBoard>

Abschnitt (unterscheidet sich von einer Umbraco UI Section) Abgrenzt Armaturenbrett Informationen zu einem oder mehreren Abschnitten anzuwenden. Die Dashboard.config kann mehrere Abschnitte enthalten.

Bereiche

Definiert, auf die Abschnitte der Umbraco UI die Teilmenge von Dashboard Informationen anzuwenden. Bereich - immer klein

Der Name * des Umbraco UI Abschnitt, wo Sie Ihre Benutzersteuerung angezeigt werden soll (zum Beispiel Inhalte, Medien, Entwickler, Einstellungen, Mitglieder oder einen benutzerdefinierten Abschnittsnamen). Sie können Ihre Steuerelemente zu mehr als einem Abschnitt, indem Sie mehrere Knoten hinzufügen.

Der Bereich mit dem ‚default‘ Namen ist das erste Armaturenbrett angezeigt, wenn eine Benutzer-Login, ganz gleich, welche Abschnitte der Benutzer Zugriff auf! Hat

Ein wenig gotcha, stellen Sie sicher, dass Sie den Namen Ihrer App in Klein sind!

Tab

Definiert eine Seite Registerkarte, die Sie Ihre Benutzerkontrolle mögen hinzugefügt werden. Das Attribut ‚Titel‘ definiert den Text auf der Registerkarte angezeigt. Es können mehrere Registerkarten für jedes Armaturenbrett „Seite“ Steuerung sein

Definiert den Pfad zur Benutzersteuerung Sie auf einer Registerkarte angezeigt werden sollen.

Das Element ermöglicht es, die Berechtigungen für Abschnitte, Tabulatoren und Kontrollen zu setzen und Sie können entweder gewähren oder verweigern bestimmten usertypes Zugang.

Es funktioniert durch das Hinzufügen eines <access/> Knoten entweder unter einem <section />, <tab/> oder <control /> Knoten. Als Kinder können Sie entweder hinzufügen

<grant /> die Berechtigungen für diese Typen von Benutzern (AND automatisch verweigern den Zugriff auf diejenigen, die nicht da sind!) Gewährt

<grantBySection /> die Berechtigungen für diese Benutzer gewährt, die den Zugriff auf bestimmte Abschnitte bekam. Dies kann für mehr granulare Berechtigungen nützlich sein

<deny /> die Berechtigungen für diese Arten von Benutzern verweigert (AND automatisch gewährt alle anderen)

Egal, die Einstellungen des Root-Benutzer (ID: 0) alles sehen kann, also keine Panik, wenn Sie Berechtigungen für Administratoren verweigern festgelegt und sind noch in der Lage, alles zu sehen; -)

Beispiel auf Berechtigungen:

<tab caption="Last Edits">
    <access>
        <grant>writer</grant>
        <grant>editor</grant>
        <grantBySection>content</grantBySection>
    </access>
    <control>/usercontrols/dashboard/latestEdits.ascx</control>
</tab>

Customizing

Um das Armaturenbrett in Umbraco zu gestalten, braucht man ein paar Dinge zu tun. Erstellen Sie eine oder mehrere Benutzersteuerelemente

Das Armaturenbrett lädt ein oder mehr Benutzersteuerelemente und zeigt sie auf einer Reihe von Registerkarten. Also, um die Steuerung zu gestalten, muss man zuerst die Benutzersteuerelemente erstellen, die auf der Seite angezeigt werden sollen. Wenn diese für Ihren eigenen persönlichen Gebrauch sind, können Sie legen Sie einfach die Benutzersteuerelemente in einem Speicherort auf Ihrer Website, die von Umbraco zugegriffen werden kann. Es wird empfohlen, dass Sie sie im / Usercontrol-Verzeichnis zu platzieren, vorzugsweise in Ihrem eigenen SubFälter. Wenn Sie ein Paket erstellen, für andere zu verwenden, sollten Sie die Benutzersteuerelemente in dem Paket enthalten, um mit dem Rest des Paketinhaltes zu installieren. Aktualisieren Sie die Dashboard.config

Wenn Sie die Benutzersteuerelemente erstellt haben, die Sie geladen haben, wenn ein Abschnitt Lasten, müssen Sie dann die Dashboard.config aktualisieren Umbraco zu sagen, Ihre Benutzersteuerelemente zu laden, wenn ein Benutzer einen neuen Abschnitt eintritt. Auch wenn Sie diese brauchen alles, was Sie für sich selbst tun, um die Dashboard.config auf Ihrer Website zu tun ist, bearbeiten Sie die Steuerelemente hinzufügen. Wenn Sie jedoch einen Abschnitt hinzufügen, mit einem Paket zu gehen, sollten Sie ein Paket Aktion gehören die Dashboard.config zu aktualisieren während der Installation. Klicken Sie hier, um weitere Informationen zu Paketaktionen. Beispiel

Im Folgenden finden Sie ein Beispiel für eine gültige Dashboard.config:

<?xml version="1.0" encoding="utf-8" ?> 
<dashBoard>
    <section>
        <areas>
            <area>content</area>
        </areas>        
        <tab caption="Last Edits">
            <access>
                <deny>editor</deny>
            </access>
            <control>/usercontrols/dashboard/latestEdits.ascx</control>
        </tab>
        <tab caption="Latest Items">
            <control>/usercontrols/dashboard/newestItems.ascx</control>
        </tab>
        <tab caption="Create blog post">
            <control>/usercontrols/umbracoBlog/dashboardBlogPostCreate.ascx</control>
        </tab>
    </section>
</dashBoard>

Was das bedeutet ist jedes Mal, wenn ein Benutzer klickt auf dem Abschnitt Inhalt der Umbraco UI (die Abschnitte in der unteren linken Ecke des Bildschirms sind) lädt es eine Seite mit drei Registerkarten „Last Edits“ genannt, „Neuesten Nachrichten“ und "Create Blog-Eintrag". Für jedes Register wird ein Benutzersteuerelement geladen, um die Funktionalität bereitzustellen, dass der Entwickler für die Laschen erstellt. Die Benutzeroberfläche findet die Benutzersteuerelemente über die Wege zur Verfügung gestellt.