Nucleus Popup Hilfe

Bitte warten Sie, während die Seite geladen wird (ca. 100KB).

Es sind zwar nicht alle, jedoch die wichtigsten Teile übersetzt worden.

Veröffentlichung in der Vergangenheit/Zukunft

Veröffentlichung in der Zukunft

Diese Option erlaubt es, einen Artikel erst zu einem bestimmten Zeitpunkt zu veröffentlichen. Der Artikel dann wird erst zu der angebenen Zeit sichtbar, davor ist er nicht auf der Seite zu sehen.

Das Datum muss in der Zukunft liegen, solange Veröffentlichungen in der Vergangenheit nicht erlaubt sind.

Veröffentlichung in der Vergangenheit

Dies erlaubt, nachträgliche Veröffentlichungen der Artikel unter einem Datum und einer Uhrzeit, die bereits vergangen ist.

Ändern des Datums oder der Zeit

Diese Option erlaubt es, das Datum oder die Uhrzeit eines Artikels zu ändern. Das Ändern des Inhalts ist eine Möglichkeit den Artikel wieder auf der Seite nach vorne zu bringen.

Die ID des Artikels wird jedoch nicht verändert.

Entwürfe

Entwürfe sind für Besucher nicht sichtbar. Dies kann praktisch sein, wenn man länger an einem Artikel arbeitet.

Erweiterter Teil

Dieser Teil ist optional für Artikel. Lange Artikel werden mit einem 'Alles lesen!' Link versehen (der genaue Wortlaut ist vom Template abhängig), wobei das normale Textfeld z.B. für eine Einleitung benutzt werden und der Rest des Artikels in den erweiterten Bereich geschrieben werden kann. Damit lässt sich verhindern, dass die Eingangsseite mit einem langen Artikel vollgeschreiben wird.

Kurzname des Blogs

Der Kurzname eines Blogs wird hauptsächlich im Administrationsinterface genutzt, um anzuzeigen, welche Artikel mit welchem Blog verknüpft sind.

Er kann ebenso als alternative Indexdatei genutzt werden, um einen zweiten Blog zugänglich zu machen:

<?
	include('./config.php');
	selectBlog('myshortblogname');
	selector();
?>

Standard Skin

Der Standard Skin kann in den Blogeinstellungen gewählt werden. Dieser Skin wird benutzt, um die Seite anzuzeigen (sofern durch Argumente in der URL kein anderer Skin gewählt ist).

Benachrichtigungsaddresse

In diesem Feld können eine oder mehrere e-Mail-Adressen abgelegt werden, die eine Benachrichtigung erhalten, wenn z.B. neue Kommentare hinzugefügt werden. Dieses Feld kann auch leer gelassen werden.

Sofern mehrere Adressen benutzt werden, sollten sie durch ein Semikolon (;) getrennt werden.

Merke: Dieses Feld fasst bis zu 128 Zeichen. Es können also nicht endlos viele Adressen eingetragen werden.
Merke: Sofern die eigene e-Mail-Adresse angegeben ist, wird keine Benachrichtigung über eigene Einträge versendet.

Maximale Kommentarzahl

Dies ist die maximale Anzahl der Kommentare, die auf der Hauptseite angezeigt werden. Dies ist KEINE Beschränkung der maximale Anzahl an Kommentaren, die gemacht werden können.. Auf der Detailseite werden alle Kommentare angezeigt!

Merke: In Templates kann diese Einstellung mit dem optionalen Parameter comments (in templevar) übergangen werden.

Zeitverschiebung

Sofern die Serverzeit von der Ortszeit des Wohnortes verschieden ist (z.B. Server in den USA, Wohnort in Deutschland), kann dies hier ausgeglichen werden.

Merke: 1.0 entspricht einer Stunde, 1.5 entsprechen 90 Minuten

Update Datei

Nucleus kann das Veröffentlichen von Artikeln in einer Datei vermerken. Diese Datei beinhaltet die Zeit der letzten Änderung. Dies kann u.U. für diverse Services sinnvoll sein.

Dieses Feld kann leer gelassen werden.

Es empfiehlt sich, einen absoluten Pfad zu benutzen (z.B. /pfad/zu/der/webseite/update.txt). Die Datei muss existieren (und Rechte von 666 besitzen).

Blog Administrator

Blog Adminsitratoren haben die folgenden Rechte:

Ein Blog kann mehere Adminsitratoren haben, aber es muss immer mindestens einer vorhanden sein.

Administratorrechte

Ein Super-Administrator hat vollen Zugang zu allen Funktionen des Weblogs, selbst wenn er nicht zu einem Team gehört.

Darüber hinaus hat ein Super-Administrator die Rechte um neue Blogs zu erstellen, generelle Einstellungen zu verändern, ebenso Templates, Skins, Benutzereinstellungen....

Normalerweise wird es nur einen Super-Administrator geben - den Webadministrator.

Kann sich anmelden?

Der Super-Administrator kann einzelnen Benutzern verbieten, sich im Administrationsinterface (gemäß ihren Rechten) zu bewegen.

Standard Blog

Dieser Blog wird benutzt, sofern die Anfrage keine speziellen Blog fordert.

Standard Skin

Diese Einstellung legt einen Skin fest, auf den ausgewichen werden kann, sofern die spezielle Blogeinstellung ungültig ist.

Normalerweise wird diese Option nicht gebraucht.

Cookies

Cookie Lebensdauer

Wenn sich ein Mitglied anmeldet, wird ein Cookie in seinem Browser gespeichert, so das er sich nicht bei jedem erneuten Besuch wieder anmelden muss. Die lebensdauer des Cookies zeigt an, nach welcher Zeit es ungültig wird:

Cookie Pfad & Cookie Domain

Dies sind erweiterte Einstellungen. Normalerweise sollten sie nicht verändert werden. In diesem Fall ist die Cookie Domain leer und der Cookie Pfad enthält einen einzelnen Slash.

Sichere Cookies

Normalerweise sollte diese Option nicht genutzt werden, außer die Cookies sollen über eine HTTPS URL ausgeliefert werden.

'Last Visit' Cookie

Nucleus kann Benutzer mit einem Cookie versehen, das dass Datum des letzten Besuchs enthält (z.B. um ein *neu* neben Artikeln aufleuchten zu lassen).

Sprache

Es gibt zwei Orte an denen die Sprache ausgewählt werden kann. In den globalen Einstellungen und in den Mitgleidseinstellungen, falls ein Mitgleid eine andere Sprache bevorzugt.

Wenn beide Einstellungen ungültig sind, benutzt Nucleus die Standarddatei.

Merke: Weitere Sprachen können von der Nucleus Webseite heruntergeladen werden (öffnet in einem neuen Fenster).

Benutzer Accounts erstellen

Es kann Benutzern gestattet oder verboten werden einen eigenen Account anzulegen. Auch mit einem Account können sie keine Artikel schreiben, solange sie nicht zu einem Team gehören.

Anmelden mit selbst erstelltem Account gestatten

Diese Einstellungen entscheiden darüber, ob sich Benutzer in der Administrationsoberfläche (gemäß ihren Rechten) bewegen dürfen.

Mitglied-zu-Mitglied-Kommunikation gestatten

Für den Datenschutz der Mitglieder können ihre e-Mail-Adressen versteckt werden. Nachrichten können Ihnen dann nur noch über ein Skript zugeschickt werden. Die Nachricht, die über das Skript verschickt wird, enthält dann allerdings beide Adressen, so das danach eine normale Kommunikation möglich ist.

Nichtmitglieder dürfen Nachrichten verschicken

Standardmäßig dürfen Nichtmitglieder keine Nachrichten über das Skript verschicken.

Site offline schalten

Es ist möglich die gesamte Seite auszuschalten, z.B. wenn man Änderungen am Design durchführt, die nicht jeder beobachten soll.

Die URL gibt die Seite an, auf die der Besucher während dieser Zeit weitergeleitet wird.

Ausnahmen: Das Administrationsinterface ist nicht offline und Superadministratoren können die Seite immer noch sehen.

URL Modus

Mit dieser Option kann zwischen URL Stilen gewechselt werden:

Merke: Für 'Fancy URLs' sind weitere Einstellungen notwendig. Diese sind hier beschrieben (öffnet in einem neuen Fenster).

Templates: Items (leider noch nicht übersetzt)

When items are shown, the following setup is repeated for each item:

item header
item body
item footer

These three blocks all refer to a template-part, which define what the result looks like.

Variables

Within these template, a series of so called template variables can be used to insert item data.

Example

An example

Templates: Items (leider noch nicht übersetzt)

An example for the item body template:

<h1><%title%></h1>

<p><%body%></p>

<div class="metadata">
 <a href="<%itemlink%>">link</a> -
 <%date%> <%time%> -
 <a href="<%authorlink%>"><%author%></a> -
 <%comments%>
</div>

The result would become something like this:

This is an item

This is the text for the item

link - August 8th 2002 18:51 - karma - no comments

Templates: comments (leider noch nicht übersetzt)

There are three possible structures for a comments block.

  1. When comments are displayed (like on detail pages, or on the main page when there are less than the maximum allowed amount of comments)
    comments header
      comments body (repeated)
    comments footer
  2. When there are no comments at all
    no comments
    
  3. When there are comments, but there are more than the maximum allowed number. (only applies when not on a detailed item page)
    too much comments
    

Inside these template-parts, some comments-related variables are available

Templates: Comment headers/footers (leider noch nicht übersetzt)

Description

While the comments-body is repeated for each comment, the header and footer are only displayed once. A typicall structure would look like this:

comments header
  comments body 1
  comments body 2
  comments body 3
comments footer

In these template-parts, comments-related templatevars are available

Examples

Header:

<ul>

Body:

<li><%user%>: <%body%></li>

Footer

</ul>

Result

Templates: Link to extended entry (leider noch nicht übersetzt)

This is the template that will be used to format the morelink templatevar that is available in the item templates. Available variables are the same as in the item templates.

When there's no extended part of the item, the <%morelink%> templatevar will have no effect.

Example

<a href="<%itemlink%>">[Read More!]</a>

Templates: Archive Lists (leider noch nicht übersetzt)

The archive lists are formatted as listed below:

archivelist header
  archivelist listitem (repeated for each archive)
archivelist footer

Available variables: (in the header and footer, only blogid is allowed)

Name Description
blogid ID of the weblog
archivelink link to the archive, which you can embed in a <a href=".."> tag.
month Number of the month (2 digits: 01-12)
year Year (4 digits)
day Day of month (2 digits; only when in day mode)

A more flexible way to add the date of the archive to the listitem, is to use strftime variables. If you find this too complicated, use the following:

<a href="<%archivelink%>">%B, %Y</a><br />

To change the language to your local settings, change the locale.

Templates: Category Lists (leider noch nicht übersetzt)

The category lists are formatted as listed below:

categorylist header
  categorylist listitem (repeated)
categorylist footer

Available variables: (in the header and footer, only blogid, blogurl and self are allowed)

Name Description
blogid ID of the weblog
blogurl URL of the blog (as defined in blogsettings)
self Current page, without parameters (e.g. index.php)
catlink a link to the most recent items for a category, which you can embed in a <a href=".."> tag.
catid Category ID
catname Category name
catdesc Category description

View an example

Templates: Category Lists Example (leider noch nicht übersetzt)

(go back)

Header

<ul>
  <li><a href="<blogurl%>">All</a></li>

List Item

<li><a href="<%catlink%>"><%catname%></a></li>

Footer

</ul>

Results in:

Templates: Locale

This is actually not a template-part, it's a setting. Setting it allows the date and time preferences when to be localized. Names of months and days will be in the desired language, etc.

The possible values depend according to which machine Nucleus is running on. Some possible values are

More info in the Open Group Specification for strftime. (opens a new window)

The locale is used for the date and time format, for the dateheaders, and for the archivelist items

Templates: Date and Time formats (leider noch nicht übersetzt)

These are used to format dates and times into the <%date%> and <%time%> vars (see template vars). The formatting is done according to the locale

More info on the available vars. If want to get started quickly, use "%x" to format the date and "%X" to format the time.

Template: Date headers/footers (leider noch nicht übersetzt)

The date header and date footer can contain date and time vars. More info on the available vars. If you want to get started quickly, use "%x" to format the date. The language which is used to format the date, is determined by the locale-setting in the template.

In the date header, the template variable <%%daylink%%> is allowed to insert a link to the archive for that day. Note the double '%'! It's necessary to avoid %d to be expanded as the current day of the month. Also, if you just want to add a '%' character somewhere, you should also put it twice ('%%') or it will be gone on your website.

Sample for date header:

<div class="day">
<h1>%d %B</h1>

Sample for date footer:

</div>

And another example for the date head using daylink

<div class="day">
<h1>%d %B</h1>
<a href="<%%daylink%%>">(archive)</a>

Templates: Highlight (leider noch nicht übersetzt)

The highlighting is used when performing searches. This is actually used in a regular expression, so you might want to escape some characters by putting a backslash before them. The place where the highlighted word will come, is indicated by "\0".

Example

<span style='background-color:yellow'>\0</span>

Templates: nothing found (leider noch nicht übersetzt)

Shown when a search has been performed and no results were found.

Available variables:

Name Description
blogid ID of the weblog
query the query that was used in the search

Example

No search results found for <b><%query%></b>

Templates: Comment body (leider noch nicht übersetzt)

This is the part of the template used to display a single comment. In this template-part, comments-related templatevars are available.

Example

<h2>Comment by <%userlink%>:</h2>

<p><%body%></p>

<div class="metadata">
 (from <%host%> on <%date%> at <%time%>)
</div>

Result:

Comment by karma:

Nice!

(from host.example.org on 2003-03-02 at 13:30)

Templates: Media & Popups (leider noch nicht übersetzt)

These templates are used to format links to popup image windows and media objects (non-pictures). The available variables for each of the templates are described below

Popup Link Code

Name Description
popuplink an <a href... link ready to use
rawpopuplink only the url inside href="..."
popupcode javascript code to open window
text the alternate text (link text)
width image width
height image width
popuptext (=same as text)
link direct link to the image (URL)
media a non-popup A-tag to the image, ready to use.

Inline Image Code

Name Description
image an IMG-tag, ready to use
link direct link to the image (URL)
text the alternate text (link text)
width image width
height image width
media an A-tag to the image, ready to use.

Media Object Link Code

Name Description
media an A-tag, ready to use
link direct link to the file (URL)
text the alternate text (link text)

Templates: Member Extra (leider noch nicht übersetzt)

This is a template you can use to add an extra indication that a comment-author is a member. It ends up in the <%authtext%> variable for use in the comment body

Inside this template-part, some comments-related variables are available.

Templates: Comments Read More (leider noch nicht übersetzt)

This is the format of the link that will be added at the end of <%short%>, which is a variable for use in the comment body

Inside this template-part, some comments-related variables are available (except for the <%short%> variable).

Example:

 <a href="<%itemlink%>">[more]</a>

Templates: commentword (leider noch nicht übersetzt)

Most likely, you'll rather want to write "1 comment" than "1 comment(s)". The "One comment" and "Many comments" template parts can be used for this purpose. They will be used to fill the <%commentword%> variable that you can use elsewhere.

If there is only 1 comment, <%commentword%> will be equal to the contents of the "one comment" part. If there are many comments (more than one), <%commentword%> will be equal to the contents of the "two (or more) comments" part.

Typical values are "comment" and "comments". No special variables can be used here.

Templates: Edit Link (leider noch nicht übersetzt)

This template defines how the edit-templatevar will be marked up. You can use any of the template variables here.

Example:

<a href="<%editlink%>"
   onclick="<%editpopupcode%>">edit</a>

Skins: Hauptseite

Hiermit werden die neusten Einträge angezeigt.

Eine sehr einfache Struktur für die Seite:

<html>
  <head>
    <title>My Weblog</title>
  </head>
  <body>

    <h1>My Weblog</h1>
    <%blog(mytemplate,20)%>

  </body>
</html>

Skins: Detailseite

Diese Seite zeigt einen kompletten Eintrag mit allen Kommentaren und einem Formular, um Kommentare hinzuzufügen.

Eine sehr einfache Struktur für die Seite:

<html>
  <head>
    <title>My Weblog :: Item</title>
  </head>
  <body>

    <h1>Item</h1>
    <%item(detailed)%>

    <h1>Comments</h1>
    <%comments(detailed)%>

    <h1>Add Comment</h1>
    <%commentform%>

  </body>
</html>

Skins: Archivliste

Generiert Links zu allen Monaten im Archiv.

Eine sehr einfache Struktur für die Seite:

<html>
  <head>
    <title>My Weblog :: Archives</title>
  </head>
  <body>

    <h1>Archives</h1>
    <%archivelist(default)%>

  </body>
</html>

Skins: Archiv

Archiv eines Monats. Verhält sich wie die Hauptseite, zeigt jedoch alle Einträge eines Monats.

Eine sehr einfache Struktur für die Seite:

<html>
  <head>
    <title>My Weblog :: Archive</title>
  </head>
  <body>

    <h1>Archive</h1>
    <%archive(default)%>

  </body>
</html>

Skins: Suche

Zeigt Suchresultate an.

Eine sehr einfache Struktur für die Seite:

<html>
  <head>
    <title>My Weblog :: Search</title>
  </head>
  <body>

    <h1>Search</h1>
    <%searchform%>

    <h1>Searchresults</h1>
    <%searchresults(default)%>

  </body>
</html>

Skins: Fehler

Wird benutzt, sofern ein Fehler auftritt.

<html>
  <head>
    <title>My Weblog :: Error</title>
  </head>
  <body>

    <h1>Error!</h1>
    <%errormessage%>

    <br /><br />

    <a href="javascript:history.back();">Back</a>

  </body>
</html>

Skins: Benutzerdaten

Zeigt Benutzerdaten an.

Eine sehr einfache Struktur für die Seite:

<html>
  <head>
    <title>My Weblog :: Member details</title>
  </head>
  <body>

    <h1>Info about <%member(name)%></h1>
    Website:
    <a href="<%member(url)%>"><%member(url)%></a>

    <h1>Send Message</h1>
    <%membermailform%>

  </body>
</html>

Skins: Popup-Bilder

Wird benutzt, sofern ein Bild in einem Popup Fenster dargestellt werden soll.

Eine sehr einfache Struktur für die Seite:

<html>
<head>
  <title><%imagetext%></title>
  <style type="text/css">
   img { border: none; }
  </style>
</head>
<body>
  <a href="javascript:window.close();"><%image%></a>
</body>
</html>

Kurznamen & Ausführliche Namen

Blogs, Templates und Skins sollten neben einem vollständigen Namen auch einen Kurznamen haben.

Ein Kurzname besteht ausschliesslich aus den Zeichen a-z und 0-9. Leerzeichen sind nicht erlaubt.

Ausführliche Namen werden für Mitglieder verwendet, diese können aus den Zeichen a-z, A-Z, Leerzeichen (nicht am Ende oder Anfang) und 0-9 bestehen.

Template: 'New' indication (leider noch nicht übersetzt)

When the 'last visit' cookie option is activated, the contents of the 'Indication of new item'-template is copied into the <%new%> variable for items that have been added since the last visit. The <%new%> variable can e.g. be used in the item body-template.

When the 'last visit' cookie is disabled, or the item is not 'new', this template part will not be used.

Time variables overview (leider noch nicht übersetzt)

The following conversion specifiers are recognized in the format string (taken from the PHP documentation for the strftime function). More info in the Open Group Specification

Weblogs.com anpingen

Sofern ein Artikel hinzugefügt wird, wird weblogs.com angepingt (benachrichtigt). Dies kann einige zusätzliche Besucher bringen!

Merke: Hierfür müssen in den Einstellungen die Blog URL sowie der Blogname angegeben sein!

Blog immer durchsuchen

Sofern aktiviert, wird der Blog immer mitdurchsucht, auch wenn auf einem zweiten oder dritten Blog eine Suchanfrage eingegeben wird.

Zeilenumbrüche umwandeln

Dies erlaubt Nucleus Zeilenumbrüche in <br /> Tags umzuwandeln, so dass der Zeilenumbruch später auch auf der jeweiligen Blogseite erkennbar ist.

Medien

Nucleus erlaubt Dateien hochzuladen.

Hierfür sind einige Einstellungen notwendig:

Jedes Mitglied hat seine eigene Dateisammlung.

Um Missbrauch zu vermeiden, können nur Mitglieder, die in einem Team sind, Dateien hochladen.

Mitgliedernamen schützen

Sofern dies aktiviert ist, ist es nicht mehr möglich unter einem Namen ein Kommentar zu posten, der bereits durch eine Registrierung vergeben wurde.

Plugin URL

Ort der Plugins. Sieht zumeist wie folgt aus:

http://hostname.com/nucleus/plugins/

Skins URL

Ort der Skins. Sieht zumeist wie folgt aus:

http://hostname.com/skins/

Action URL

Ort des action.php Skriptes. Sieht zumeist wie folgt aus:

http://hostname.com/actions.php

Eintrag hinzufügen

Beim Hinzufügen eines Eintrages können die folgenden vier Template Variablen benutzt werden.

Normalerweise können diese Variablen über das Bedienfeld eingefügt werden.

Skinvar: referer

Fügt eine URL ein

Argumente

Keine

Skintypus

Alle

Beispiel

<a href="<%referer%>">back</a>

Skinvar: itemid

Fügt die ID des Artikels ein

Argumente

Keine

Skintypus

item

Beispiel

<%itemid%>

Skinvar: itemlink

Fügt einen permanenten Link für den Artikel ein.

Argumente

Optional

Skintypus

item

Beispiel

<%itemlink%>

Skinvar: itemtitle

Fügt den Titel eines Artikels ein

Argumente

Keine

Skintypus

item

Beispiel

<%itemtitle%>

Skinvar: archivedate

Fügt ein formatiertes Datum für das Archiv ein

Argumente

Skintypus

archive

Beispiel

Archive für <%archivedate%>
Archive für <%archivedate(dutch)%>
Archive für <%archivedate(en,%B %Y)%>

Skinvar: blog

Fügt die neuesten Artikel des aktiven Blogs ein.

Argumente

Benötigt:

Optional:

Skintypus

index, item, archive, archivelist, search

Beispiel

<%blog(default,15)%>
<%blog(default,5(15))%>
<%blog(mytemplate)%>
<%blog(mytemplate,5,mycategory)%>

Skinvar: otherblog

Fügt die neuesten Artikel eines bestimmten Blogs ein.

Argumente

Benötigt:

Optional:

Skintypus

Alle

Beispiel

<%otherblog(myblog,default,15)%>
<%otherblog(yourblog,mytemplate)%>
<%otherblog(yourblog,mytemplate,15,mycategory)%>
<%otherblog(yourblog,mytemplate,5(15),mycategory)%>

Skinvar: item

Zeigt den Artikel ohne Kommentare, basierend auf einem Template.

Argumente

Skintypus

item

Beispiel

<%item(mytemplate)%>

Skinvar: comments

Zeigt die Kommentare eines Artikels, basierend auf einem Template.

Argumente

Skintypus

item

Beispiel

<%comments(mytemplate)%>

Skinvar: archive

Zeigt das Archiv für ausgewählten Monat und Blog, basierend auf einem Template.

Argumente

Benötigt

Optional

Skintypus

archive

Beispiel

<%archive(mytemplate)%>
<%archive(mytemplate,mycategory)%>

Skinvar: otherarchive

Zeigt das Archiv für den ausgewählten Monat, basierend auf dem Blog und auf einem Template.

Argumente

Benötigt

Optional

Skintypus

archive

Beispiel

<%otherarchive(myblog,mytemplate)%>
<%otherarchive(myblog,mytemplate,mycategory)%>

Skinvar: archivelist

Zeigt eine Liste der verfügbaren Archive auf einem Blog, basierend auf einem Template.

Argumente

Benötigt

Optional

Skintypus

index, archive, archivelist, search, item

Skinvar: archivedaylist

Das Gleiche wie archivelist skinvar, zeigt allerding einen Eintrag für jeden Tag statt für jeden Monat.

Argumente

Benötigt

Optional

Skintypus

index, archive, archivelist, search, item

Beispiel

<%archivedaylist(mytemplate)%>
<%archivedaylist(mytemplate,mycategory)%>

Skinvar: otherarchivedaylist

Das Gleiche wie archivelist skinvar, zeigt allerding einen Eintrag für jeden Tag statt für jeden Monat.

Argumente

Benötigt

Optional

Skintypus

Alle

Beispiel

<%otherarchivedaylist(yourblog,mytemplate)%>
<%otherarchivedaylist(yourblog,mytemplate,mycategory)%>

Skinvar: otherarchivelist

Zeigt die verfügbaren Archive eines Blogs, basierend auf einem Template.

Argumente

Benötigt

Optional

Skintypus

Alle

Beispiel

<%otherarchivelist(yourblog,mytemplate)%>
<%otherarchivelist(yourblog,mytemplate,mycategory)%>

Skinvar: categorylist

Fügt eine Liste der Kategorien eines Blogs ein, basierend auf einem Template.

Argumente

Benötigt

Optional

Skintypus

index, archive, archivelist, search, item

Beispiel

<%categorylist(mytemplate)%>
<%categorylist(mytemplate,myweblog)%>

Skinvar: category

Fügt Informationen über die ausgewählte Kategorie ein.

Argumente

Optional

Skintypus

Alle

Beispiel

<%category%>
<%category(id)%>
<%category(desc)%>
<%category(name)%>

Skinvar: ifcat

Inaktiv seit Nucleus 2.0. Benutze stattdessen <%if(category)%>.

Argumente

Keine

Skintypus

Alle

Beispiel

<%ifcat(Momentane Kategorie: )%><%category%>

Skinvar: searchresults

Zeigt die Resultate einer Suchanfrage an.

Argumente

Benötigt:

Optional:

Skintypus

search

Beispiel

<%searchresults(mytemplate)%>

Skinvar: othersearchresults

Zeigt die Resultate einer Suchanfrage (eines bestimmten Blogs) an, basierend auf einem Template.

Argumente

Benötigt:

Optional:

Skintypus

search

Beispiel

<%othersearchresults(myblog,mytemplate)%>

Skinvar: query

Fügt die Suchanfrage ein.

Argumente

Keine

Skintypus

search

Beispiel

<%query%>

Skinvar: version

Fügt die Nucleus Version ein.

Argumente

Keine

Skintypus

Alle

Beispiel

<%version%>

Skinvar: previtem

Fügt die ID des vorangegangenen Artikels ein.

Argumente

Keine

Skintypus

item

Beispiel

<%previtem%>

Skinvar: nextitem

Fügt die ID des folgenden Artikels ein.

Argumente

Keine

Skintypus

item

Beispiel

<%nextitem%>

Skinvar: nextitemtitle

Fügt den Titel des nächsten Artikels ein.

Argumente

Keine

Skintypus

item

Beispiel

<%nextitemtitle%>

Skinvar: previtemtitle

Fügt den Titel des vorangehenden Artikels ein.

Argumente

Keine

Skintypus

item

Beispiel

<%previtemtitle%>

Skinvar: prevarchive

Fügt ein archive Attribut ein, das mit einem Archiv, das einen Tag (oder Monat) in der Vergangenheit liegt, korrespondiert.

Argumente

Keine

Skintypus

archive

Beispiel

<a href="index.php?archive=<%prevarchive%>>....

Skinvar: nextarchive

Fügt ein archive Attribut ein, das mit einem Archiv, das einen Tag (oder Monat) später liegt, korrespondiert.

Argumente

Keine

Skintypus

archive

Beispiel

<a href="index.php?archive=<%nextarchive%>>....

Skinvar: archivetype

Endweder day (Tag) oder month (Monat) - zeigt, welche Archivart angezeigt wird.

Argumente

Keine

Skintypus

archive

Skinvar: todaylink

Fügt einen Link zur Hauptseite des Blogs ein. Berücksichtigt den betrachteten Blog und die Kategorie.

Argumente

Optional

Skintypus

Alle

Beispiel

<%todaylink%>

Skinvar: archivelink

Fügt einen Link zum Archiv des Blogs ein. Berücksichtigt den betrachteten Blog und die Kategorie.

Argumente

Optional

Skintypus

Alle

Beispiel

<%archivelink%>

Skinvar: nextlink

Fügt einen Link zum nächsten Artikel auf der Seite (oder im Archiv) ein.

Argumente

Optional

Skintypus

item, archive, search, index

Beispiel

<%nextlink%>

Skinvar: prevlink

Fügt einen Link zum nächsten Artikel auf der Seite (oder im Archiv) ein. Für Such- und Indexseiten.

Argumente

Optional

Skintypus

item, archive, search, index

Beispiel

<%prevlink%>

Skinvar: errormessage

Gibt eine entsprechende Fehlermeldung aus.

Argumente

Keine

Skintypus

error

Beispiel

<%errormessage%>

Skinvar: imagetext

Inaktiv seit Nucleus v2.0. Stattdessen sollte <%image(caption)%> genutzt werden.

Popup Bild

Argumente

Keine

Skintypus

imagepopup

Beispiel

<%imagetext%>

Skinvar: image

Fügt das ausgewählte Bild für ein Popup Bild ein.

Argumente

Optional

Skintypus

imagepopup

Beispiel

<%image%>

Skinvar: vars

Inaktiv seit Nucleus v2.0. Bitte ausweichen auf: itemid skinvar

Fügt ein verstecktes Formularfeld mit der Artikel ID ein.

<input type="hidden" name="itemid" value="1234" />

Argumente

Keine

Skintypus

item

Skinvar: sitevar

Fügt eine Seitenvariable ein.

Argumente

Skintypus

Alle

Beispiel

<%sitevar(name)%>
<%sitevar(url)%>
<a href="mailto:<%sitevar(email)%>">Admin</a>

Skinvar: blogsetting

Fügt eine bestimmte Einstellung für den Blog ein.

Argumente

Skintypus

index, archive, archivelist, search, item, member

Beispiel

<%blogsetting(name)%>
<%blogsetting(id)%>
<%blogsetting(desc)%>
<a href="<%blogsetting(url)%>">...</a>

Skinvar: member

Fügt Informationen über den angemeldeten Benutzer ein.

Argumente

Skintypus

Alle

Beispiel


<%if(loggedin)%>
you are <%member(yourrealname)%>
<%endif%>

Skinvar: preview

Fügt eine Artikelvorschau ein, basierend auf einem Template.

Argumente

Skintypus

index

Beispiel

<%preview(mytemplate)%>

Skinvar: adminurl

Fügt die URL des Administrationsinterfaces ein.

Argumente

Keine

Skintypus

Alle

Beispiel

<a href="<%adminurl%>">Admin Area</a>

Skinvar: additemform

Zeigt ein Formular zum hinzufügen eines Artikels an.

Argumente

Keine

Skintypus

index

Beispiel

<%additemform%>

Skin/Templatevar: include

Fügt der Ausgbe eine Textdatei an. Die Inhalte der Datei werden nicht geparst!

Argumente

Merke

Skintypus

Alle

Beispiel

<%include(filename.txt)%>
<%include(/home/user/myself/filename.txt)%>
<%include(http://mydomain.com/filename.html)%>

Skin/Templatevar: phpinclude

Fügt der Ausgabe ein PHP File hinzu. Die Inhalte werden geparst!

Argumente

Merke

Skintypus

Alle

Beispiel

<%phpinclude(filename.php)%>
<%phpinclude(/home/user/myself/filename.php)%>

Skin/Templatevar: phpinclude : vars

Die folgenden globalen Variablen können von Dateien genutzt werden, die von phpinclude hinzugefügt wurden:

$GATEWAY_INTERFACE, $SERVER_NAME, $SERVER_SOFTWARE
$SERVER_PROTOCOL, $REQUEST_METHOD, $QUERY_STRING
$DOCUMENT_ROOT, $HTTP_ACCEPT, $HTTP_ACCEPT_CHARSET
$HTTP_ACCEPT_ENCODING, $HTTP_ACCEPT_LANGUAGE
$HTTP_CONNECTION, $HTTP_HOST, $HTTP_REFERER
$HTTP_USER_AGENT, $REMOTE_ADDR, $REMOTE_PORT
$SCRIPT_FILENAME, $SERVER_ADMIN, $SERVER_PORT
$SERVER_SIGNATURE, $PATH_TRANSLATED, $SCRIPT_NAME
$REQUEST_URI, $argv, $argc, $PHP_SELF
$HTTP_COOKIE_VARS, $HTTP_GET_VARS, $HTTP_POST_VARS
$HTTP_POST_FILES, $HTTP_ENV_VARS, $HTTP_SERVER_VARS
$HTTP_SESSION_VARS, $PATH_INFO, $HTTPS
$HTTP_RAW_POST_DATA, $HTTP_X_FORWARDED_FOR

Für andere Variablen muss dem Code folgendes hinzugefügt werden: 'global $varname;'

Skin/Templatevar: parsedinclude

Fügt der Ausgabe eine Datei hinzu. Die Inhalte werden vom Nucleus Skin/Template parser geparst.

Argumente

Merke

Skintypus

Alle

Beispiel

<%parsedinclude(filename.txt)%>
<%parsedinclude(/home/user/myself/filename.txt)%>

Skin/Templatevar: plugin

Ruft ein Plugin auf.

Argumente

Merke

Skintypus

Alle

Beispiel

<%plugin(Calendar)%>
<%plugin(LastComments,myweblog)%>
<%LastComments(myweblog)%>

Skinvar: loginform

Fügt ein Formular zum Anmelden ein, oder zeigt "Angemeldet als Chris! (Abmelden)".

Argumente

Keine

Skintypus

Alle

Beispiel

<%loginform%>

Skinvar: commentform

Fügt ein Kommentarformular ein.

Argumente

Optional:

Skintypus

item

Beispiel

<%commentform%>
<%commentform(http://host/thanks.html)%>

Skin/Templatevar: set (leider noch nicht übersetzt)

Sets a parser property.

Arguments

Skintypes

all

Examples

<%set(IncludeMode,skindir)%>
<%set(IncludePrefix,somedir/)%>

Skin/Templatevar: skinfile (leider noch nicht übersetzt)

Used by imported skins to put a link relative to the skins-URL. Use it in conjunction with the IncludePrefix parser property to get the best results

Arguments

Skintypes

all

Examples

<%skinfile(mystyle.css)%>

Skin/Templatevar: skinname (leider noch nicht übersetzt)

Inserts the name of the skin that's currently being used.

Arguments

None

Skintypes

all

Examples

<%skinname%>

Skinvars: if/else/endif (leider noch nicht übersetzt)

Inserts a content block only when certain conditions are fullfilled

Arguments

Only the if skinvar has options

Condition types

Skintypes

all

Examples

<%if(loggedin)%>
Welcome back!
<%else%>
Welcom guest!
<%endif%>
<%if(category,catname,Off Topic)%>
Welcome to the 'Off Topic' category.
<%endif%>

Notes

If you want something to be displayed only if a condition is not fullfilled, you can use a construct like this:

<%if(skintype,error)%><%else%>
<%blogsetting(name)%>
<%endif%>

Skinvar: membermailform (leider noch nicht übersetzt)

Shows a form through which a logged-in member can send a message to the member which details are being shown (on member detail pages)

Arguments

Optional:

Skintypes

member

Examples

<%membermailform%>

Skinvar: searchform (leider noch nicht übersetzt)

Shows a search form for the current blog.

Arguments

Optional:

Skintypes

index, archive, archivelist, search, item

Examples

<%searchform%>
<%searchform(otherweblog)%>

Skinvar: nucleusbutton (leider noch nicht übersetzt)

Inserts a nucleus button, with link to the Nucleus website.

Arguments

Optional:

Notes

Skintypes

all

Examples

<%nucleusbutton%>
<%nucleusbutton(nucleus/nucleus.gif,46,43)%>

Skinvar: self (leider noch nicht übersetzt)

Inserts the filename of the page currently being displayed (index.php or whatever you changed it to)

Arguments

None

Skintypes

all

Examples

<%self%>

Template variables: Overview (leider noch nicht übersetzt)

What?

Template variables largely work in exact the same way as skin variables, with the only difference that they are being used inside templates. The variables are called using <%varname%>, and include some text depending on the variable function. Some variables also have extra optional parameters.

Available variables

These template variables be used in the following template-parts: item header, item body, item footer, date header, date footer, morelink, editlink (The variables image, popup and media can also be used inside weblog items.)

Comments-related template-parts (comments header, comments body, comments footer, one comment, two comments, comments read more, no comments, too much comments) have a different set of available variables:

Template variables: Basic variables (leider noch nicht übersetzt)

All these variables concern the item that's currently being parsed.

Name Description
title item title
body body text
more extended text
category name of the category
categorylink raw link to the category
karma karma score
authorlink raw link to the author
itemlink raw permanent link for the item
author name of the author
smartbody either the body text or the extended text
morelink 'read more'-link
date Formatted date
time Formatted time
daylink raw link to the daily archive
comments comments block or commentcount
itemid ID of the item
blogurl URL of the blog

Template variables overview...

Template variables: Advanced variables (leider noch nicht übersetzt)

Name Description
authorid ID of the current items author
blogid ID of the blog
catid ID of the category for the current item
query search query (if there is one)
syndicate_title Syndicated title
syndicate_description Syndicated body text
karmaposlink raw vote link
karmaneglink raw vote link
new 'New Item!'-text
include includes a file, whithout parsing
parsedinclude includes a file, parsing it
phpinclude includes a file, parsing by PHP
plugin executes a plugin
edit inserts an 'edit this item' link
editlink raw 'edit item' link (links to bookmarklet)
editpopupcode javascript code to open a popup window for editlink
skinfile includes the correct URL for a file belonging to an imported skin
set sets a parser property
image inline image from media library
popup popup image from media dir
media other media object from media dir
relevance Includes the 'search hit relevance' in templates that display search results

Template variables overview...

Template variables: Comments (leider noch nicht übersetzt)

Name Description
body comment body
user user name
userid users URL or e-mail address
userlink a smart link to either the e-mail or URL for non members, or the member detail page for members. Note: this link already includes the <a href="..."> and </a> tags ! (when no valid URL or e-mail is available, only the name of the member will be shown)
userlinkraw same as above, but without the <a href.., empty when no valid URL or e-mail available
useremail the e-mail address of the user, empty if the e-mail address was not provided by the user
userwebsite the URL of the users website, empty if the URL was not provided by the user
memberid ID of the member (0 for non-members)
commentcount total amount of comments for the item
commentword 1 'comment', 2 'comments'
date date on which comment was added
time time at which comment was added
host host from where comment was added
ip IP-address from where comment was added
commentid ID of the current comment
itemid ID of the current item
itemlink link to the detailed item page
itemtitle Title of the current item
blogid ID of the weblog
blogurl URL of the weblog
authtext the extra text for members, empty for non members
short a cut off version of the body, which truncates after the first line break. A link is added at the end according to the template
excerpt the body of the comment, cut at 60 characters and appended with '...'
timestamp time at which comment was added
include includes a file, whithout parsing
parsedinclude includes a file, parsing it
phpinclude includes a file, parsing by PHP
plugin executes a plugin
skinfile includes the correct URL for a file belonging to an imported skin
set sets a parser property

Template variables overview...

Templatevar: karma (leider noch nicht übersetzt)

Inserts karma votes data. Karma votes are a method to vote the 'karma' of an item. With a single click, the visitor can vote either positive or negative. The total of all these votes gives an idea of how much an item is liked by the visitors

Arguments

Examples

<%karma(posp)%> out of <%karma(votes)%> were positive

Templatevar: templateitemtitle (leider noch nicht übersetzt)

On comments-releated templateparts, inserts the title of the associated item.

Arguments

Templatevar: author (leider noch nicht übersetzt)

Inserts the name of the author

Arguments

Examples

<%author%>
<%author(realname)%>
<a href="<%author(url)%>"><%author%></a>

Templatevar: smartbody (leider noch nicht übersetzt)

Examines the current item and then decides to show either the body text or the expanded text.

When the extended part is empty, the body part is chosen. Otherwise the extended part is shown.

PartEmpty?
BodyNoNo
ExtendedYesNo
smartbody=body partextended part

Example use

The body text could be interpreted as your full text, and the extended part could be interpreted as an 'introduction' or 'exerpt', which you want to show on the front page.

In the template used on the front page, you would use <%smartbody%> to insert an excerpt (if there is one), or the full text (if no excerpt). In the template for detailed items, <%body%> can then be used instead of the usual <%body%> + <%more%>, since <%body%> will contain the full item anyway.

Templatevar: morelink (leider noch nicht übersetzt)

Inserts a link to the detail page for the item, as defined in the template (link to extended entry). This is empty when there is no extended part.

Note that the contents of the 'link to extended entry' templatepart is also parsed and can thus also contain templatevariables.

Templatevar: date (leider noch nicht übersetzt)

Inserts a date using the date format specified in the template. Optionally, a custom date format can be given as a parameter.

Arguments

Specials

Four special parameters are possible:

  1. rfc822: RFC822 date in local time
  2. rfc822GMT: RFC date in GMT time
  3. iso8601: ISO-8601 date (W3C Date and Time Format profile). Example: 2002-10-02T10:00:00-05:00
  4. utc: Same as iso8601, but the date is expressed in UTC, using a "Z" for the timezone indicator.

Examples

<%date%>
<%date(%x)%>
<%date(rfc822)%>
<%date(rfc822GMT)%>

Templatevar: time (leider noch nicht übersetzt)

Inserts a time using the time format specified in the template. Optionally, a custom time format can be given as a parameter.

Arguments

Examples

<%time%>
<%time(%X)%>

Templatevar: comments (leider noch nicht übersetzt)

Inserts a comments 'block'. More information about the structure of this block.

Arguments

Examples

<%comments%>
<%comments(5)%>

Templatevar: syndicate_title (leider noch nicht übersetzt)

Inserts the title of the item, with HTML tags-stripped off, and shortened to 100 characters. When the text needs to be shortened, "..." is added at the end of the text.

This variable was originally intended for use in the XML-RSS skin that comes with Nucleus, but can also be of use in other situations.

Arguments

Examples

<%syndicate_title%>
<%syndicate_title(25)%>

Templatevar: syndicate_description (leider noch nicht übersetzt)

Inserts the body of the item, with HTML tags-stripped off, and shortened to 250 characters. When the text needs to be shortened, "..." is added at the end of the text.

This variable was originally intended for use in the XML-RSS skin that comes with Nucleus, but can also be of use in other situations.

Arguments

Examples

<%syndicate_description%>
<%syndicate_description(25)%>

Templatevar: image (leider noch nicht übersetzt)

Inserts an inline image into an item body or template.

In normal use, the image-templatevar is generated automatically when adding images through the media library. You can call it from within templates too, though. Note that in this last case, the image will come out of the media dir of the current item's author.

Arguments

Examples

<%image(myphoto.jpg|100|200|this is me)%>
<%image(myphoto.jpg|50%|50%|this is me, but smaller)%>

Templatevar: popup (leider noch nicht übersetzt)

Inserts a popup image into an item body or template.

In normal use, the popup-templatevar is generated automatically when adding images through the media library. You can call it from within templates too, though. Note that in this last case, the image will come out of the media dir of the current item's author.

Arguments

Examples

<%popup(myphoto.jpg|100|200|this is me)%>
<%popup(myphoto.jpg|50%|50%|this is me, but smaller)%>

Templatevar: media (leider noch nicht übersetzt)

Inserts a media object into an item body or template.

In normal use, the media-templatevar is generated automatically when adding images through the media library. You can call it from within templates too, though. Note that in this last case, the object will come out of the media dir of the current item's author.

Arguments

Examples

<%media(mysong.mp3|listen to my new song)%>

Templatevar: edit (leider noch nicht übersetzt)

From within your template, you can add an 'edit item' link by using this template variable. By default, it will link to a popup-bookmarklet-window, but that behaviour can be changed through the editlink template.

Note: only logged in members that are allowed to edit the item will see this link. In other cases, the edit-templatevar does nothing at all.

Example

An example for the item body template

<h1><%title%></h1>
<p><%body%> <%morelink%></p>
<div class="metadata">
	<%edit%> <%comments%>
</div>

Results in

Title

This is an item

edit - 5 comments

Templatevar: editlink (leider noch nicht übersetzt)

Insert a link to the 'edit item' bookmarklet. This can be used in the editlink template for simplicity.

Example

The 'edit link'-template could look like this:

<a href="<%editlink%>"
   onclick="<%editpopupcode%>">edit</a> -

Templatevar: editpopupcode (leider noch nicht übersetzt)

To open a popup window for the 'edit link' window, you'll need to add some javascript code to your link. To avoid having to enter this code in the 'edit link'-template, you can insert it using the editpopupcode-templatevar.

Example

See the example for the editlink templatevar

Plugins

Nucleus ermöglicht durch die Integration von Plugins die Funktionalität zu erweitern. Plugins machen verschiedenes möglich:

  1. Sie fungieren als Variable eines Skins
  2. Sie fungieren als Variable eines Templates
  3. Fügen sich in Inhalte ein, die durch Nucleus generiert werden. Die Position im Plugin Management regelt die Reihenfolge.
  4. Können durch action.php aufgerufen werden und Diverses darstellen.

Die Verantwortung für Plugins liegt vollständig (!) beim jeweiligen Autor. Er sollte sicherstellen, dass es funktioniert.

Parser Properties (leider noch nicht übersetzt)

The available parser options are described below.

Parser properties
Option Name Values
IncludeMode
  • normal: normal behaviour; included files are taken relative to the directory/url of the .php file generating the page.
  • skindir: included files are taken relative to the skindir/skinurl

This property affects the following skinvars: include, phpinclude, parsedinclude, nucleusbutton

IncludePrefix

This property is a prefix that get's added in front of each filename you want to include. For example, if the prefix is base/ and you want to include somefile.txt, you'll end up including base/somefile.txt

This property is intended to be used in conjunction with the IncludeMode property. This way, a skin imported to skindir/somename/ can set IncludeMode to skindir and IncludePrefix to somename/

This property affects the following skinvars: include, phpinclude, parsedinclude, nucleusbutton

The IncludePrefix and IncludeMode properties can be set globally for a skin in the general settings of a skin. Also note that from the moment a property is set, it applies to all parsed data, thus also for templates.