Manchmal ist es von Nöten, dass man dem User Optionen für das eigene Theme anbietet. Dies kann aus Design-Gründen, zum Beispiel für verschiedene Backgrounds oder auch eine Kategorieauswahl, zur Darstellung der Artikel in einer im Design integrierten Box.
In diesem Post möchte ich euch einen guten Weg aufzeigen, eure eigene Options-Seite für euer Theme zu bauen. Diese Seite wird ein Text-Feld beinhalten sowie eine Auswahl an verschiedenen Kategorien für eine Auflistung in einer Box. Der Clou an der Sache ist, dass wir alle Daten dieser Options-Page in einem einzigen Datenbank-Eintrag speichern.

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');
}

Version 1.1.1 des Punkt . 16 PHP Kalender!

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!

Ein PHP-basierender Kalender, welcher den aktuellen Tag markiert.

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; broder: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!

Gestern hatte ich das Problem, dass json_encode alle Strings mit einem Umlaut einfach gelöscht hatte. utf8_encode brachte auch nichts. Deswegen schnell eine eigene jsonEncode();-Funktion geschrieben!

Diese Funktion ersetzt die json_encode-Funktion komplett. Selbst mehrdimensionale Arrays sind kein Problem, da die Funktion rekursiv programmiert ist.

function jsonEncode($array)
{
	$zaehler = 1;
	$ret = '{';
 
	foreach($array as $key => $val)
	{
		$ret .= '"' . $key . '":';
 
		if(is_string($val))
		{	
			if(empty($val))
			{
				$ret .= 'null';	
			}
			else
			{
				$val_e = str_replace('"', '\"', $val);
				$val_e = str_replace('/', '/', $val_e);
 
				$ret .= '"' . $val_e . '"';	
			}
		}
		elseif(is_bool($val))
		{
			if($val == true)
			{
				$ret .= 'true';	
			}
			elseif($val == false)
			{
				$ret .= 'false';	
			}
		}
		elseif(is_array($val))
		{
			$ret .= jsonEncode($val);	
		}
		elseif(is_null($val))
		{
			$ret .= 'null';
		}
 
		if($zaehler < count($array))
		{
			$ret .= ',';
		}
 
		$zaehler++;
	}
 
	$ret .= '}';
 
	return $ret;
}

Heute gibt es einen kleinen Code-Snippet, welcher einen zufällig generierten Code zurückgibt.

Die Funktion:

function getRandomString($types = array('lowtypes', 'bigtypes', 'nummerics'), $fix = false, $max = 20, $min = 1)
{
	$strings = "";
	$output = "";
 
	foreach($types as $type)
	{
		switch($type)
		{
			case 'lowtypes':
					$strings .= 'abcdefghijklmnopqrstuvwxyz';
				break;
 
			case 'bigtypes':
					$strings .= 'ABCDEFGHJIKLMNOPQRSTUVWXYZ';
				break;
 
			case 'nummerics':
					$strings .= '0123456789';
				break;
		}
	}
 
	$letters = (!$fix) ? rand($min, $max) : $max;
 
	for($i = 0; $i < $letters; $i++)
	{
		$output .= $strings[rand(0, strlen($strings) - 1)];
	}
 
	return $output;
}

Funktionsaufruf:

//große & kleine Buchstaben + Zahlen, beliebige Größe, min 10 Zeichen, max 20 Zeichen
echo getRandomString(array('lowtypes', 'bigtypes', 'nummerics'), false, 20, 10);
 
//große Buchstaben + Zahlen, Fixe Größe von 15 Zeichen
echo getRandomString(array('bigtypes', 'nummerics'), true, 15);

Wie erstelle ich eigene URLs um zum Beispiel eine Variable übergeben zu können?

Um eigene Router zu implementieren, öffnen wir als erstes die index.php aus dem “public”-Ordner.
Hier schreiben wir nun, nach dem wir die Application erstellt, die Bootstrap geladen und ausgeführt haben, folgende Zeile um einen neuen Rewrite-Router zu erstellen:

$router = new Zend_Controller_Router_Rewrite();

Als nächstes möchten wir einen eigenen Router anlegen. Wir nehmen nun mal an, dass wir einen NachrichtenController haben, sowie eine lesenAction. An diese Action möchten wir nun über die URL die ID mitgeben. Als Name für den Router verwenden wir “nachrichtlesen”:

$router->addRoute('nachrichtlesen');

Hier würde Zend noch meckern, da er eine Klasse des Typs Zend_Controller_Router_Route erwartet. In diesen Klassen-Aufruf schreiben wir, wie die URL aussehen soll, dass eine ID übergeben werden soll und welcher Controller / welche Action verwendet werden soll:

$router->addRoute(
	'nachrichtlesen',
	new Zend_Controller_Router_Route('nachrichten/lesen/:id',
									array('controller' => 'nachrichten',
										  'action' => 'lesen'))
);

Zur Erklärung:
“nachrichten/lesen/” ist die URL, wie sie später aussehen wird (http://beispiel.de/nachrichten/lesen/).
:id ist ein Parameter, der Übergeben wird.
Das Array enthält die Bestimmung, welcher Controller (nachrichten) / welche Action (lesen) verwendet werden soll.

Jetzt noch die Routen an die Application übergeben:

$ctrl = Zend_Controller_Front::getInstance();
$ctrl->setRouter($router);

In einer unsere Views erstellen wir nun ganz einfach eine URL mithilfe des URL-Helpers, welcher auf diese Route zugreift:

$this->url(array('id' => '3'), 'nachrichtlesen', true);

Dies ergibt folgende Ausgabe:

http://beispiel.de/nachrichten/lesen/3

Im NachrichtenController & der lesenAction können wir dies nun wie gewohnt über die Request-Methode verarbeiten:

$id = $this->getRequest()->getParam('id');