In diesem Artikel möchte ich gar nicht auf die komplette Funktionalität und die einzelnen Parameter der Custom Post Types eingehen, da es dazu schon genug Artikel im WWW gibt. Ich möchte euch hier jedoch zeigen, wie Ihr einfach eigene “Fähigkeiten” ( Capabilities ) für den Post Type hinzufügen könnt, ohne auf die Fähigkeit publish_post o.ä. zurückgreifen zu müssen.

Angenommen Ihr habt einen CPT um einige Produkte zu verwalten und euer Code zum erstellen des CPT schaut wie folgt aus:

add_action( 'init', 'register_addresses' );

function register_addresses(){

	register_post_type( 'addresses',
		array(
			'public'    =>        true,
			'rewrite'    =>        array(
				'slug'        =>        'adresse',
			),
			'supports'    =>        array(
				 'title',
				 'editor',
				 'thumbnail',
			),
			'labels'    =>        array(
				'name'                =>        'Adressen',
				'singular_name'        =>        'Adresse',
				'add_new'            =>        'Adresse erstellen',
				'add_new_item'        =>        'Neue Adresse erstellen',
				'edit_item'            =>        'Adresse bearbeiten',
				'new_item'            =>        'Neue Adresse',
				'view_item'            =>        'Adresse ansehen',
				'search_items'        =>        'Adresse suchen',
				'not_found'            =>        'Keine Adresse gefunden',
				'not_found_in_trash'=>        'Keine Adresse im Papierkorb gefunden',
			),
			'menu_position' => 70,
			'map_meta_cap' => true,
			'capability_type' => array( 'address', 'addresses' ),
		)
	);

}

Nun prüft WordPress bei jedem Aufruf auf die Berechtigung read_posts, publish_posts oder delete_posts. Jedoch möchten wir, dass Adressen nur von der Verwaltung voll gepflegt werden dürfen. Andere, z.b. Autoren dürfen nur neue Adressen erstellen. Da aber die Autoren in unserem Fall Posts auch löschen dürfen, benötigen wir hier weitere Einschränkungen.
Dazu ergänzen wir die Parameter um zwei weitere:

'map_meta_cap' => true,
'capability_type' => array( 'address', 'addresses' ),

Der Parameter map_meta_cap gibt an, dass nicht nach den Standard-Befugnissen geprüft werden soll, sondern eben nach denen, die für diesen Post Type bestimmt sind.
Mit capability_type geben wir an, wie die neuen Befugnisse überhaupt heißen. In unserem Fall würden nun die Standard-Befugnisse durch folgende ersetzt:

Auszug aus print_r( $GLOBALS['wp_post_types']['addresses'] ); :
[cap] => stdClass Object
        (
            [edit_post] => edit_address
            [read_post] => read_address
            [delete_post] => delete_address
            [edit_posts] =>edit_addresses
            [edit_others_posts] => edit_others_addresses
            [publish_posts] => publish_addresses
            [read_private_posts] => read_private_addresses
            [read]=>; read
            [delete_posts] => delete_addresses
            [delete_private_posts] => delete_private_addresses
            [delete_published_posts] => delete_published_addresses
            [delete_others_posts] => delete_others_addresses
            [edit_private_posts] => edit_private_addresses
            [edit_published_posts] => edit_published_addresses
        )

Nun können wir der Verwaltung alle Befugnisse zuweisen und den Autoren z.B. nur edit_address, edit_addresses, read_address und publish_addresses zuweißen. Dies kann mit einem von vielen Plugins geschehen, oder in eurem Plugin-Code. ( Vergesst nicht, dem Administrator ebenfalls rechte zu geben! Andernfalls wird er nicht einmal den Menüpunkt sehen können. )

/* Rolle auslesen */
$author = get_role( 'author' );

/* Befugnisse hinzufügen */
$author->add_cap( 'edit_address' );
$author->add_cap( 'edit_addresses' );
$author->add_cap( 'read_address' );
$author->add_cap( 'publish_addresses' );

Ich hoffe, dieser kleine Artikel zu Custom Post Types und den erweiterten Berechtigungen hat euch geholfen bei eurem eigenen Projekt weiter zu kommen.

Leider konnte ich während dem (WordPress-) Projekt nicht so viel schreiben, da es einfach verdammt viel Zeit in Anspruch genommen hat / nimmt. Nun, das ist bald vorbei, dann werde ich hier einige Artikel nachtragen. Was kommen wird? Einiges!:

• Funktions-Bibliothek ( Alles mögliche an nützlichen Funktionen, welche ich für dieses Projekt verwendet habe )
• Sidebar-Widgets
• Custom Post Types
• Custom Post Types Übersicht ( Eigene Spalten, Sortiermöglichkeiten, Einschränkungsmöglichkeiten )
• Installations-Routinen
• fpLoadClass
• …

Bis dahin!

Als allererstes erstellen wir eine Funktion, in welcher WordPress gesagt wird, dass wir nun eine neue Options-Page erstellen. Dadurch müssen wir uns nicht groß um die Speicherung der Daten kümmern.

//functions.php

//die funktion
function ctheme_options_init(){
  //Registrieren der Options "ctheme_theme", die Speichervariable in der Tabelle "ctheme_theme_options" und eine Validierungs-Funktion ("ctheme_options_validate", dazu später mehr)
  register_setting('ctheme_theme', 'ctheme_theme_options', 'ctheme_options_validate');
}

add_action('admin_init', 'ctheme_options_init');

Damit auch etwas dargestellt werden kann, benötigen wir eine do_page-Funktion. In dieser könnt ihr eine externe Datei inkludieren, um eine bessere Übersicht zu behalten. Ich schreibe es für dieses Tutorial direkt mit hinein.

<?php function ctheme_options_do_page(){
?>
<div class="wrap">
  <h2>cTheme Theme Optionen</h2>

  <form action="options.php" method="post">
    <?php //Schreibt verschiedene hidden Inputs
    settings_fields('ctheme_theme'); ?>
    <?php //Hier werden die gespeicherten Optionen abgefragt. Wir erinnern uns, dass wir alles in einem Eintrag speichern!
    $options = get_option('ctheme_theme_options'); ?>

    <table class="form-table">
      <tbody>
        <tr valign="top">
          <th scope="row">Titel der Box</th>
          <td><input type="text" value="" name="" id="" /></td>
        </tr>
        <tr>
          <th scope="row">Kategorie für die Auflistung in der Box</th>
          <td>Hier stehen dann die Kategorien..</td>
        </tr>
      </tbody>
    </table>

    <p class="submit"><input class="button-primary" type="submit" value="<?php _e('Save Changes') ?>" /></p>

    </form>
  </div>
<?php } ?>

Da wir alle Daten nur in einem Datenbankeintrag speichern, müssen wir die vom User eingegeben Daten selbst validieren.

function ctheme_options_validate($input){
	$input['boxtitle'] = ( $input['boxtitle'] == '' ) ? 'Standard-Box' : $input['boxtitle'];
	$input['categorylist'] = ( is_array( $input['categorylist'] ) ) ? $input['categorylist'] : array();
	return $input;
}

Nun müssen wir die Werte noch änderbar machen. Fangen wir mit der Input-Box an:

<tr valign="top">
  <th scope="row">Titel der Box</th>
  <td><input type="text" value="<?php echo $options['boxtitle']; ?>" name="ctheme_theme_options[boxtitle]" id="ctheme_theme_options_boxtitle" /></td>
</tr>

Wie Ihr seht, verwenden wir hier als name-Attribute den $options-Name als Array. (Hm, ist der Satz denn jetzt verständlich?)

Machen wir uns nun an die Auswahl der Kategorien. Dazu brauchen wir zwei Funktionen: Die eine listet alle Kategorien rekursive auf. Dafür ist es notwendig zu prüfen, ob die aktuelle Kategorie in der Schleife eine Unter-Kategorie hat, die zweite Funktion.

/***************
* list subcategories
* @categories wp-get_categories-Array
* @categoryId choosen category
* @label label to save in options
* @options the options
*******************/
function ctheme_options_listcategory( $categories, $categoryId, $label, &$options ) {
        //alle kategorien durchgehen, um die gewünschten Kategorien zu erhalten...
        // 0 gibt z.B. alle Top-Kategorien aus, 8 z.B. nur die, welcher eine Sub-Kategorie der Top-Kategorie 8 ist
	foreach( $categories as $category ):
                //Hat diese Kategorie die gewünschte ID?
		if( $category->category_parent == $categoryId ):
		?>
			<li>
				<input name="ctheme_theme_options[<?php echo $label; ?>][]" type="checkbox" value="<?php echo $category->term_id; ?>" <?php if(@in_array($category->term_id, $options[$label])) { echo 'checked="checked"'; } ?> /> <?php echo $category->name; ?>
				<?php
                                //Ruft nun die 2. Funktion auf, um zu prüfen, ob diese Kategorie weitere Kategorien enthält
                                if($subcats = ctheme_options_hassubcategory($categories, $category->term_id)): ?>
					<ul style="padding-left:20px; margin-bottom:14px;">
						<?php
                                                //Sollte dies der Fall sein, rufe ctheme_options_listcategory erneut auf
                                                ctheme_options_listcategory( $categories, $category->term_id, $label, $options ); ?>
					</ul>
				<?php endif; ?>
			</li>
	<?php endif;
	endforeach;
}

/* check, if the given categoryid is in the category-array */
function ctheme_options_hassubcategory( $categories, $categoryId ){
	$hasSubcategory = false;

	foreach( $categories as $category ) {
		if( $category->category_parent == $categoryId) {
			$hasSubcategory = true;
			break;
		}
	}

	return $hasSubcategory;
}

In unserer do_page-Funktion können wir die Kategorie-Funktion nun einfach mit dem Label, welchen wir in der Validierungs-Funktion angegeben haben, aufrufen.

<tr>
  <th scope="row">Kategorie für die Auflistung in der Box</th>
  <td>
    <?php
        //Alle Kategorien von WordPress mit hide_empty=0 abfragen... Wir benötigen alle Kategorien für die Optionen
        $allCategories = get_categories('hide_empty=0');

        ctheme_options_listcategory( $allCategories, 0, categorylist, $options );
    ?>
  </td>
</tr>

Als letztes müsst ihr die Options-Seite noch an die Theme-Navigation im Admin-Bereich hängen:

//register options page
add_action('admin_menu', 'ctheme_menu');

function ctheme_menu(){
	add_theme_page('cTheme Optionen', 'Optionen', 'edit_theme_options', 'ctheme-options', 'ctheme_options_do_page');
}

Einige werden es noch nicht mitbekommen haben, dass ich nun mit Punkt 18 (.com) selbstständig bin. Gut, vor kurzem bekam ich einen recht großen Auftrag. Ich solle doch bitte ein Plugin für WordPress entwicklen. Gut, kein Ding, mach ich. In enger zusammenarbeit mit der Firma und deren Kunden wird das auch ein richtig schönes Ding!

Hier im Blog werde ich in der Zeit meine gesammelte Erfahrung, Lösungsansätze und Lösungen präsentieren. Für alle, die auch mal auf die selben Probleme stoßen.
Auch wird es eventuell ab und an ein kleines Plugin an sich für WordPress geben, welche ich zeitgleich entwickle, um eventuelle Probleme zu lösen.

Gerne sind natürlich Kommentare gesehen. Auch, wenn ihr natürlich möchtet, einen Beitrag über WordPress / PHP, welchen Ihr mir per E-Mail an blog@punkt16.de zukommen lassen könnt.

In diesem Sinne!:

$startedochendlich = new Blog();

$startedochendlich->starteJetzt('!!!');

import flash.events.TimerEvent;
import flash.utils.Timer;

var myTimer:Timer = new Timer(5000); //Timer-Klasse, alle 5 Sekunden
myTimer.addEventListener(TimerEvent.TIMER, myFunction); //Welche Funktion soll alle x Sekunden aufgerufen werden?
myTimer.start(); //Den Timer starten

Ganz einfache Spielregeln und jeder kann sofort mitspielen!

1.Schnappe dir das Buch, welches am nächsten bei dir liegt. Jetzt!
2. Schlage Seite 56 auf.
3. Suche den 5. Satz.
4. Schreibe diesen Satz als Kommentar zu diesem Beitrag.

Bei mir ist es:
“Die Erfahrung von Albert Camus, der die Absurdität des Lebens kannte, aber an ihr nicht verzweifelt ist, möchte auch uns ermutigen, mitten in der Kälte unseres Herzens die unbesiegbare Wärme der Sonne zu sehen.”

Was das bringt?! Nichts! Aber macht auf eine Art und Weiße Spass!

Mit der neuen Version des Kalenders, erweitert sich der Funktionsumfang um Feiertage & Ferien.

Als Beispiel fügen wir Silvester dieses Jahres hinzu. Da Silvester jedes Jahr statt findet, verwenden wir für die Jahreszahl ein Sternchen ( * ). Diese Sternchen könnt ihr Nutzen wie Ihr möchtet, d.h. auch für Tage und Monate.

$kalender->addHoliday('Silvester', '31.12.*');

Oder habt Ihr vllt an jedem 5. Tag im Monat ein Fest?

$kalender->addHoliday('Monats-Party', '05.*.*');

Schon gewusst?
Ihr könnt noch zwei Paramter bei “addHoliday” übergeben:
Eine URL, welche beim Klick auf den Eintrag auf eine Seite weiterleitet
Eine CSS-Klasse, welche dieser Tag bekommen soll!

So könnt Ihr z.B. Weihnachten (welches schon fest hinterlegt ist ) schön hinterlegen

$kalender->addHoliday('Weihnachten', '24.12.*',
'http://deineseite.de/weihnachten.html', 'weihnachten');

Der 24.12. wird zu http://deineseite.de/weihnachten.html verlinkt und bekommt die Klasse “weihnachten”, welche diesen Tag vielleicht rot hinterlegt?

Möchtet Ihr einen eingetragenen Feiertag wieder löschen, wie zum Beispiel “Heilige drei Könige” (fest Eingetragen), verwendet Ihr folgende Funktion:

$kalender->removeHoliday('06.1.*');

So werden genau die Feiertage ausgetragen, welche am 06.1.* stattfinden.

Weiter habt ihr die Möglichkeit, ganze Ferien einzutragen:

$kalender->addVacation('26.12.2009', '29.12.2009', 'Testferien');

Das erste Datum ist der Beginn, das zweite Datum das Ende (wird markiert). Der Dritte Parameter “Testferien” ist der Name dieser Ferien.
Hier könnt Ihr auch, wie oben, zwei weitere Parameter anhängen, welche eine URL und eine CSS-Klasse behinhalten.

Ferien könnt ihr löschen, in dem Ihr beim Funktionsaufruf von removeVacation den Namen dieser Ferien übergebt:

$kalender->removeVacation('Testferien');

Ein kompletter Code könnt nun so aussehen:

$deutscheDaten=array('daysLong'=>array('Montag','Dienstag','Mittwoch','Donnerstag','Freitag','Samstag','Sonntag'),'daysShort'=>array('Mo','Di','Mi','Do','Fr','Sa','So',),'monthsLong'=>array('Januar','Februar','März','April','Mai','Juni','Juli','August','September','Oktober','November','Dezember'),'monthsShort'=>array('Jan','Feb','März','Apr','Mai','Juni','Juli','Aug','Sep','Okt','Nov','Dez'));

$kalender= new Punkt16_Calendar($deutscheDaten);
$kalender->addHoliday('Silvester', '31.12.*');
$kalender->addHoliday('Monats-Party', '05.*.*');
$kalender->removeHoliday('06.1.*');
$kalender->addVacation('26.12.2009', '29.12.2009', 'Testferien');
$kalender->removeVacation('Testferien');

echo $kalender->getCalendar();

Ein Beispiel mit den neuen Funktionen könnt ihr euch hier ansehen: http://examples.punkt16.de/PHP/Kalender1.1.1/
Die benötigten Dateien könnt Ihr euch hier downloaden!

Ein Backlink zu www.punkt16.de ist erwünscht, aber nicht Pflicht!

Wer hat es noch nie Versucht: Man tipper auf einem Klavier, zupft auf seiner Gitarre, singt vielleicht noch bisschen was dazu. Schön und gut. Nur klingt dies oft nicht sonderlich gut. Auf «Incredibox.fr» könnt Ihr euch nun euer eigenes kleines Lied zusammenbauen.

Man wählt zwischen einigen Instrumenten, Rythmen, Effekten, Chor-Stimmen und Stimmen und zieht Sie in den Figuren. Sofort wird wiedergegeben, was man gerade zusammengesetzt hat. Ausserdem kann man, nach einiger Zeit, zwischen den verschienden Bonus-Modis wechseln.

Viel Spaß auf «Incredibox.fr»

Heute gibt es ein Skript für einen PHP-basierenden Kalender! Das Skript selbst erkläre ich nicht, da es den Rahmen mehr als sprengen würde. Allerdings erkläre ich euch, wie einfach es Anzuwenden ist! Die PHP-Klasse, welche ihr benötigt, könnt ihr euch hier downloaden.

Als ersters solltet Ihr das Skript includen:

include('calendar.class.php');

Nun müsst Ihr ein neues Objekt instanzieren. Das heisst nichts anderes, als den Kalender aufzurufen und in einer Variable fest zu halten.

$kalender = new Punkt16_Calendar();

Jetzt noch die Funktion getCalendar aufrufen, und mit echo ausgeben:

echo $kalender->getCalendar();

Der komplette Code für den Standard-Kalender sieht wie folgt aus:

include('calendar.class.php');
$kalender = new Punkt16_Calendar();
echo $kalender->getCalendar();

Ihr habt nun aber englische Monats- und Tagesnamen. Um diese zu ändern, müsst Ihr beim instanzieren des Objekts ein Array mit den deutschen Namen übergeben.
Euer Array sieht so aus:

$deutscheDaten = array(
					   'daysLong' => array(
										   		'Montag',
												'Dienstag',
												'Mittwoch',
												'Donnerstag',
												'Freitag',
												'Samstag',
												'Sonntag'
										   ),

					   'daysShort' => array(
												'Mo',
												'Di',
												'Mi',
												'Do',
												'Fr',
												'Sa',
												'So',
											),

					   'monthsLong' => array(
											 	'Januar',
												'Februar',
												'März',
												'April',
												'Mai',
												'Juni',
												'Juli',
												'August',
												'September',
												'Oktober',
												'November',
												'Dezember'
											 ),

					   'monthsShort' => array(
											  	'Jan',
												'Feb',
												'März',
												'Apr',
												'Mai',
												'Juni',
												'Juli',
												'Aug',
												'Sep',
												'Okt',
												'Nov',
												'Dez'
											  )
					   );

Falls Ihr euren Code nicht so aufblähen möchtet, hier die kurze Fassung:

$deutscheDaten=array('daysLong'=>array('Montag','Dienstag','Mittwoch','Donnerstag','Freitag','Samstag','Sonntag'),'daysShort'=>array('Mo','Di','Mi','Do','Fr','Sa','So',),'monthsLong'=>array('Januar','Februar','März','April','Mai','Juni','Juli','August','September','Oktober','November','Dezember'),'monthsShort'=>array('Jan','Feb','März','Apr','Mai','Juni','Juli','Aug','Sep','Okt','Nov','Dez'));

Übergebt nun dem Objekt diese Daten:

$kalender = new Punkt16_Calendar($deutscheDaten);

Kompletter Code:

include('calendar.class.php');
$deutscheDaten=array('daysLong'=>array('Montag','Dienstag','Mittwoch','Donnerstag','Freitag','Samstag','Sonntag'),'daysShort'=>array('Mo','Di','Mi','Do','Fr','Sa','So',),'monthsLong'=>array('Januar','Februar','März','April','Mai','Juni','Juli','August','September','Oktober','November','Dezember'),'monthsShort'=>array('Jan','Feb','März','Apr','Mai','Juni','Juli','Aug','Sep','Okt','Nov','Dez'));
$kalender = new Punkt16_Calendar($deutscheDaten);
echo $kalender->getCalendar();

Eure Ausgabe sieht wohl noch etwas sehr weiss aus. Deswegen benötigt Ihr noch eine passende CSS, welche dem Download oben beiliegt:

table.calendar { width:210px; border:1px solid #a6c9e2; margin:50px auto auto;}
table.calendar table.title { width:100%; height:30px; border:1px solid #c5dbec; background:#5c9ccc; text-align:center;}
table.calendar table.title td.monthBackwardA { width:30px; color:#fff; }
table.calendar table.title td.monthBackwardA a { font-size:18px; color:#fff; width:30px; height:30px; line-height:30px; display:block; text-decoration:none; }
table.calendar table.title td.monthYear { font-size:14px; line-height:30px; color:#fff;}
table.calendar table.title td.monthForwardA { width:30px; color:#fff;}
table.calendar table.title td.monthForwardA a { font-size:18px; color:#fff; width:30px; height:30px; line-height:30px; display:block; text-decoration:none;}
table.calendar td.dayName { text-align:center; font-weight:bold; }
table.calendar td.dayA { border:1px solid #c5dbec; background:#dfeffc; color:#2e6e9e; text-align:center;}
table.calendar td.dayA.dayTodayA { border:1px solid #fad42e; background:#fbec88; color:#363636;}
table.calendar td.dayA.dayOther { border:1px solid #e6f4ff; background:#f6fbff; color:#98d3ff; }

Ein Beispiel mit deutschen Namen könnt ihr euch hier ansehen: http://examples.punkt16.de/PHP/Kalender/

Ein Backlink zu www.punkt16.de ist erwünscht, aber nicht Pflicht!

Zwar sind sie nichtmehr so populär wie noch vor 3 Jahren, allerdings findet man sie trotzdem noch oft genug.

Für diejenigen, die schon an dieser Stelle nicht mehr mitreden können, erkläre ich kurz, wovon ich überhaupt spreche.
Enterseiten sind Seiten, die vor der eigentlichen Hauptseite stehen, sie sind also eine Art Eingangstor auf die der User in den meisten Fällen klicken muss. Auf solchen Seiten werden meistens Grafiken und Buttons gezeigt, die wie ein Wegweiser für den User dienen sollen.

Nun stellt sich folgende Frage: “Sind solche Seiten überhaupt sinnvoll?”
Nunja, es mag vielleicht auch Geschmackssache sein, doch es gibt auch einige Argumente, die dieses Thema erläutern.

Was spricht also für eine Enterseite, wieso gibt es sie überhaupt?
- Wichtige Informationen werden sofort vom User aufgenommen
- Der User kann auf wichtige Unterseiten hingewiesen werden (Forum, Chat, …)
- Es kann so der Status der Seite vermittelt werden (Offline, Umbau, Urlaubspause, …)
- Man kann mit einer eindrucksvollen Enterseite den User neugierig auf die Seite machen, sodass sich dieser die Seite im Nachhinein vielleicht genauer anschaut.

Doch trotzdem gibt es Sachen, die dagegen sprechen:
- Der User wird durch den “Aufhalt” vor dem eigentlichen Ziel genervt.
- Eine schlechte Gestaltung der Enterseite kann den User abschrecken, sodass er nicht bis zur Hauptseite geht.
- Wenn auf der Enterseite zu viel Informationen geliefert werden und diese dann zu einer halben Hauptseite wird, hat der User vielleicht schon genug gesehen, braucht so nicht noch mehr Informationen und besucht deshalb die eigentliche Hauptseite garnicht.

Nun kann man sich darüber streiten, welche Argumente gewichtiger sind. Also ist es wohl besser, wenn jeder seine eigene Meinung dazu bildet. Meiner Meinung nach sind Enterseiten überflüssig, da sie, wie gesagt, einen überflüssigen Aufenthalt vor dem eigentlichen Ziel sind und deshalb unnötige Zeit rauben. Außerdem treffe ich bei Enterseiten häufig auf Werbung, welche mich dann schon nervt und mich nichtmehr dazu motiviert, die eigentliche Hauptseite zu besuchen, sofern ich das nicht unbedingt muss.
Das war von mir, zum Thema “Enterseiten sinnvoll?”.

Gruß, Take!