Handbuch:Erweiterung/BlueSpiceSocialBlog

Die Erweiterung BlueSpiceSocialBlog ist Teil von BlueSpiceSocial, dem Kommunikationsmodul von BlueSpice. Neben dem Typ Blog gibt es noch andere Typen von sogenannten sozialen Einheiten, z. B. Kommentare, Diskussionsthemen, Anhänge oder Microblogs.

Wie funktioniert das

Was ist ein Blog?

Grundsätzlich

<section begin="training /">Grundsätzlich ist ein Blog eine Liste von inhaltlichen Beiträgen wie Kommentare, Fragen oder Rückmeldungen verschiedener Benutzer. Das Blog ist oft chronologisch abwärts sortiert, im Sinne eines öffentlich zugänglichen Journalsaufgebaut. Eine lebendige lebhafte Kommunikation kann entstehen, wenn die Beiträge weiter kommentiert, weiter empfohlen, mit informativen Artikeln verlinkt verwandten Seiten verknüpft oder auf eine persönliche Beobachtungsliste gesetzt werden.

SocialBlog ist Bestandteil von BlueSpiceSocial, dem Kommunikationsmodul von BlueSpice. Neben dem Typ Blog gibt es in diesem Modul noch die weiteren Typen Kommentar, Diskussion und Microblog. Beiträge aus allen diesen Typen können mit BlueSpiceSocial in einer Timeline-Anzeige chronologisch dargestellt werden und bezüglich Anzeige, Funktionen und Filtermöglichkeiten konfiguriert werden.

Die Blog Spezialseite

Die Blogfunktion wird auf der Spezialseite Spezial:blog gebrauchsfertig bereitgestelltDie Blog-Funktion steht auf der Seite Spezial:Blog zur Verfügung. Diese Seite ist bei in jeder neuen Wiki-Installation in direkt von der Hauptnavigation aus verlinkt. Zusätzlich kann die Seite auch über Links in Wikiseiten eingebunden und aufgerufen werden. Sie können also sofort loslegen und sich einen Eindruck vom Blog verschaffen. Die Einschränkung über diesen Weg ist, dass sich der Blog ausschließlich auf dieser Spezialseite befindet.

Das Blog

So können Sie sofort mit der Nutzung des Blogs beginnen. Es ist auch möglich, die Blog-Funktionalität in jede Wiki-Seite aufzunehmen. <section end="training /">Legen wir also gleich los!

Beiträge können alternativ in einer Timeline konsolidiert und chronologisch angezeigt sowie nach Bedarf gefiltert und sortiert werden.

Das Blog auf einer Seite einbinden

Wenn Sie das Blog eine Ansicht Ihres Blogs auf einer beliebigen Seite, z.B. der Startseite anderen Seite Ihres Wikis , einbinden wollen, geben möchten, beispielsweise auf Ihrer Homepage, müssen Sie den nötigen erforderlichen Codeblock in der Quelltextbearbeitung ein. Um ein Blog auf einer Seite einzubinden:

Wechseln Sie auf die

den Quellcode Ihrer Seite einfügen.So fügen Sie eine Blogansicht hinzu:

1. Gehen Sie zu der Seite, auf der Sie das Blog einbinden wolleneinfügen möchten oder erstellen Sie eine neue Seite.
2. Öffnen Sie die Quelltextbearbeitung Seite in der SeiteQuellbearbeitung.
   
3. Kopieren Sie folgenden Codeblock an die gewünschte Stellezum Seitenabschnitt, in dem Sie das Blog anzeigen wollen.

                               <bs:timeline>
    {
        "showentitylistmenu": true,
        "preloadtitles": {
            "blog": "Vorlage:Blog"
        },
        "preloadedentities": [{
            "type": "blog"
        }],
        "headlinemessagekey": "Community-Blog",
         "
                           

usemorescroll

1.                             showheadline": 
                           

false

1.                             true,
        "
                           

showheadline

1.                             usemorescroll": 
                           

true

1.                             false,
        "morelink": "Special:Blog",
        "limit": 5,
        "sort": [ {
            "property": "timestampcreated",
            "direction": "DESC"
        }],
        "lockedfilternames": [
            "type"
        ],
        "filter": [ {
            "type": "list",
            "property": "type",
            "value": [ "blog" ],
            "comparison": "ct"
        }]
    }
   </bs:timeline>
   
                           

   Nach dem Speichern

die Änderungen.

Die Blogfunktion steht nun in einer Ausgangsversion bereit und kann genutzt werden. Über diverse Parameter, die in den Codeblock integriert werden, können Anpassungen vorgenommen werden.

Blog über eine Vorlage einbinden

1. der Seite sehen Sie die Liste der Blogeinträge des Wikis. Die Liste basiert auf den angegebenen Filter- und Sortierungskriterien.
   

Blog Parameter

Der Codeblock/Tag der die Blogfunktion bereitstellt, kann in einer Vorlage hinterlegt werden und an beliebiger Stelle im Wiki eingebunden werden.

• Kopieren Sie folgende Codeblock in die Vorlage
  

<includeonly> {{#tag:bs:timeline| { "showentitylistmenu": false, "showentityspawner": false, "preloadedentities": [{ "type": "blog" }], "headlinemessagekey": "Letzter Blogeintrag", "usemorescroll": false, "showheadline": false, "morelink": "Special:Blog", "limit": {{{limit}}}, "sort

Ausgabeformat

Die folgende Tabelle zeigt die Blog-Elemente und die erforderlichen Parameter zum Erstellen der Blogansicht:

Element	Parameters	Parameter and element description	Type	Default value
1 - Überschrift	headlinemessagekey	Überschrift	string	Timeline
	showheadline	Überschrift anzeigen	boolean	true
2 - Blogmenü	showentitylistmenu	Blogmenü anzeigen	boolean	true
	showentityspawner	Textfeld zum Erstellen eines Blogeintrags anzeigen	boolean	true
	availablesorterfields	Datenfelder die als Sortieroptionen im Sortierungsmenü verfügbar sind. Beispiel: Benutzer können nur nach Erstellungsdatum oder Urheber sortieren: "availablesorterfields":["timestampcreated","ownerid"] Liste typischer Sortierfelder	array	alle
	lockedoptionnames	Diese Sortierfelder können vom Benutzer nicht geändert werden.	array	[]
	availablefilterfields	Datenfelder die als Filteroptionen im Filtermenü vorhanden sind. Beispiel: Benutzer können nach Erstellungsdatum oder Verknüpfte Artikel filtern: "availablefilterfields":["timestampcreated","tags"]	array	alle
	lockedfilternames	Diese Filtereinstellungen können nicht geändert werden. Beispiel: Ein Benutzer kann den Filter Verknüpfte Seiten nicht verändern. Das Feld ist ausgegraut: "lockedfilternames": ["tags"]	array	[]
	persistsettings	Initiale Einstellungen und vom Benutzer vorgenommene Einstellungen werden in die URL übernommen. Die URL kann dann auf anderen Seiten verlinkt werden. "persistsettings":true	boolean	false
3 - Neuer Blogeintrag	preloadentities	Zeigt das Textfeld zum Erstellen einen neuen Blogeintrags. Wenn es nicht angegeben ist, wird das Textfeld nicht nagezeigt. Anzeige des Textfelds mit: "preloadedentities": [{"type":"blog"}]	array of objects	-
4 - Existierender Blogeintrag	outputtypes	Definiert, welche Entitytypen mit welchem format angezeigt werden. Standardtypen sind: List, Short, Default, Page. (siehe Beispiele) Jeder Blogeintrag ist eine social entity.	object	Default
	limit	Definiert, wie viele social entities initial dargestellt werden.	object	Default
4a - Avatar	-	Zeigt den Avatar des Benutzers der den Blogeintrag oder den Kommentar erstellt hat. Er wird in allen Ausgabeformaten außer List angezeigt.	-	-
4b - Titelleiste	-	Im Ausgabeformat List wir der Benutzername in der Titelleiste nicht angezeigt.	-	-
4c - Inhalt des Blogeintrags	-	Zeigt den Textkörper des Blogeintrags an. Das Ausgabeformat Default klappt den Inhalt nach dem ersten Paragraphen ein. Der Inhalt wird über den Link Mehr ausgeklappt.	-	-
4d - Social Tags	-	Blogeinträge enthalten immer die Social Tags Kommentar, Empfehlen, Verknüpfter Artikel, Beobachten/Nicht mehr beobachten.	-	-
4e - Benutzermenu	-	Benutzer können Ihre eigenen Blogeinträge jederzeit bearbeiten oder löschen. Das Benutzermenü ist nur bei den eigenen Beiträgen sichtbar:	-	-
5 - Neuer Kommentar	-	Textfeld zum Erstellen eines neuen Kommentars.	-	-
6 - Existierender Kommentar	-	Kommentare enthalten das Social Tag Empfehlen. Jeder Kommentar ist eine social entity.	-	-
7 - Schaltfläche "Mehr"	morelink	Linkziel für die Schaltfläche Mehr. Für Blogs ist es sinnvoll, zur Seite Spezial:Blog zu verlinken.	str	Spezial:Timeline
	useendlessscroll	Mehr Blogeinträge werden nachgeladen, wenn der Benutzer ans Ende der Liste scrollt.	boolean	true
	showentitylistmore	Zeigt die Schaltfläche Mehr an, welche beim Anklicken mehr Blogeinträge lädt. Dies ist nur möglich, wenn useendlessscroll auf false eingstellt ist.	boolean	false

Sortierung

Generell werden in einem Blog die neuesten Blogeinträge zuerst angezeigt. Es gibt jedoch viele verschiedene Möglichkeiten, die Liste der Blogeinträge zu sortieren.

Syntax

                    [{

"property": "timestamptouched",

"direction": "DESC"

}]

                

Attribute

Ein Blogeintrag hat einige Attribute, die für die Sortierung nützlich sind:

Attribut	Beschreibung
timestampcreated	creation date
timestamptouched	last edit date
commentcount	number of comments
ratingcount	number of ratings
ownerid	username of the creator of a blog entry
ownerrealname	real name of the user

Richtung

Blogeinträge können in absteigender und aufsteigender Reihenfolge sortiert werden. Absteigend ist die Standardsortierung.

Wert	Beschreibung
DESC	sorts the blog entries in descending order
ASC	sorts the blog entries in ascending order

Filtern

Wenn der Parameter Filter nicht existiert, gibt es keine Blogausgabe.

Um die Blogeinträge Ihres Wikis anzuzeigen, schließen Sie den folgenden Codeblock ein, wie im obigen Codebeispiel gezeigt:

                    "filter": [ {
            "propertytype": "timestampcreatedlist",
            "directionproperty": "DESCtype",
        } "value": [ "blog"  ],
    "lockedfilternames": [         "type"comparison": "ct"
     }],
    

                

Dieser Filter enthält alle sozialen Einheiten, die dem Typ Blog entsprechen. Da wir nur social entities vom Typ Blog anzeigen möchten, nehmen wir auch nur Blogeinträge in unseren Filter auf. Wenn Sie anstelle einer Blogansicht eine Timeline erstellen möchten, können Sie auch andere Arten von social entities hinzufügen. Das folgende Beispiel zeigt eine Timeline-Ansicht mit Blogeinträgen, Diskussionseinträgen von Wiki-Seiten und Benutzerprofilinformationen:

                    "filter": [ {
            "type": "list",
            "property": "type",
            "value": [ "blog" ,"topic","profile"],
            "comparison": "ct"
     }]

                

Beispiele für die Ausgabeformate

Der Ausgabetyp für ein Blog wird mit dem Parameter outputtypes hinzugefügt. Vergessen Sie nicht, vor und nach diesem Parameter ein Komma einzufügen (es sei denn, dies ist der letzte Parameter in Ihrem Codeblock):

                    "outputtypes": {
}     ] }
}}
</includeonly>
                

Um die Vorlage auf der Seite einzubinden:

1. Öffnen Sie die Seite, in der Sie das Blog einbinden wollen, im Bearbeitungsmodus.
2. Klicken Sie auf Einfügen > Vorlage.
3. Speichern Sie die Änderungen.

Blogeinträge erstellen

                      "blog": "Default"
    }

                

Default

Der Ausgabetyp Default zeigt den Inhalt eines Blogeintrags an, der nach dem ersten Absatz eingeklappt wird. Um den vollständigen Text anzuzeigen, können Benutzer auf den Link Mehr klicken.

Short

Um einen neuen Blogeintrag zu erstellen:

1. Klicken Sie in das Textfeld Neuer Blog.
2. Schreiben Sie denTitel und Inhalt Ihres Beitrags.
3. Klicken Sie auf . Ihr Eintrag wurde nun im Blogformat erstellt.

Blogformat bedeutet ein ansprechendes Design, worüber Inhalt, Verfasser und Zeitpunkt der Erstellung zügig erfasst werden können. So kann ein lebendiger Austausch zu einem interessanten Thema entstehen.

Aufbau eines Blogbeitrags

Der Ausgabetyp Short zeigt den Inhalt des Blogeintrags nicht an. Um den Inhalt anzuzeigen, müssen Benutzer auf den Titel eines Blogeintrags klicken. Dadurch wird die aktuelle Seite für den ausgewählten Blogeintrag geladen.

Page

In der Menüleiste finden Sie folgende Funktionen:

• Beiträge sortieren: z.B. absteigend nach dem Erstelldatum > der aktuellste Eintrag ist oben
• Beiträge filtern: z.B. nur Blogeinträge anzeigen, die mit einem bestimmten Artikel verknüpft sind

Über Parameter können die Filter-und Sortiermöglichkeiten eingestellt werden > Defaulteinstellung, verfügbare und gesperrte Filter-/ Sortiermöglichkeiten.

Weitere Schaltflächen in der Menüleiste:

• Neu anlegen > legt ein leeres Blogformat an
• Liste neu laden > aktualisiert die Liste

Der 3-Punkte-Button rechts oben im farblich abgesetzten Blogfeld, öffnet den Dialog zum Bearbeien und Löschen.

Der Mehr-Button rechts unter dem Inhalt, klappt den kompletten Blogbeitrag aus.

Die Social-Leiste mit speziellen Social-Funktionen

• Klicken Sie auf Kommentare und erfassen Sie einen Kommentar zum Blogbeitrag
• Klicken Sie auf Empfehlen
• Klicken Sie auf Verknüpfter Artikel. Tippen Sie den Namen des Wiki-Artikels ein, den Sie mit dem Blogeintrag verknüpfen möchten und lassen Sie sich bei der Suche von der Vorschlagliste unterstützen.
• Klicken Sie auf den Schalter Beobachten/ Nicht mehr beobachten, wenn Sie ein Auge darauf haben wollen, wie die Diskussion weiterverläuft oder die Beobachtung beenden wollen.

Siehe auch

Unsere Referenz-Seite Der Ausgabetyp Page zeigt alle Elemente des Blogs, einschließlich der Kommentare, vollständig ausgekappt an.

List

Der Ausgabetyp List zeigt nur den Titel und das Erstellungsdatum an.

Verwandte Themen

• Micro-Blog
• Diskussionen und Anhänge
• Diskussionsbeiträge
• Kommentare
• Benutzerprofil

• Verknüpfte Artikel
• Referenz:BlueSpiceSocial