Heute ist net mein Tag! Die letzten Tage waren und sind nicht meine Tage. Das ist nicht meine Welt! Und überhaupt ist alles scheiße! Kurz und knackig auf den Punkt gebracht, was mich bewegt. Jawohl.
Und warum das Ganze? Weil ich mich mit Inkompetenz etc. herumschlagen musste. Und weil ich mein neues Design dieses Blogs – bzw. das Template hiervon – vorstellen möchte. Und so.
Informationstechnischer Wahnsinn
Nachdem ich meinem Apache mal endlich ein self-signed SSL-Zertifikat verpasste, stellte ich fest, dass der doofe Internet Explorer Probleme damit hat. Das als Inspiration genommen um einen Blog-Eintrag in meinem Corporate-Blog von dismar it & more zum Thema “Internet Explorer: SSL-Zertifikat nachinstallieren” zu verfassen. So weit, so schlecht.
Nachdem der Eintrag stand, wollte ich noch die Daten von diesem Blog hier sichern. Hab’ ich auch. Geplant war, diese Daten in die Datenbank meines Testservers zu importieren, um eben was zu testen. Leider ging der Plan schief. Aber so richtig. Ich löschte mal eben zwei Datenbanken, weil der Testserver immer noch den selben Datenbestand anmeckerte. Unglücklicherweise – war es nicht der Testserver, der die Datenbanken verlor, sondern mein Produktivserver (karnaya.de eben) Sch…!!!
Ich hatte ja ein Backup. Dachte ich. Es war ein einfacher SQL-Dump, der nicht viele Freunde – äh – MB hatte. Er lag so auf meiner Festplatte herum. Nachdem er dann auch auf des Servers Platte lag, importierte ich ihn wieder. Unglücklicherweise kam es zu Problemen: die Umlaute waren kaputt! ARGH.
recode? – Nee, löst das Problem auch nicht. Hmmm, Problemanalyse: karnaya.de-Datenbankdump, Zeichensatz: UTF-8. Datenbank, in die das File gedumped werden soll, Zeichensatz: UTF-8. Probleme? – Umlaute! “Was tun?”, sprach Zeus – und ich packte das File in eine Zip-Datei und importierte den ganzen Kram abermals – oh Wunder: Umlaute! Dazu sei angemerkt: bis auf dass das File in ein Zip-gepackt wurde, wurde nix geändert. UTF-8 ist die Standard-Collation, etc… Muss man das begreifen? Kann mir einer erklären, was genau das Problem sein könnte, und dieses Verhalten auf eine logische Ebene ziehen?
Da ich ja noch eine weitere Datenbank geschossen habe versehentlich gelöscht habe, stellte sich mir die Frage: “was tun?”, abermals. Nunja, es gibt solche tollen Web-2.0-Dienste, z.B. technorati. Zum Glück pinge ich diese immer an – und mein Artikel war schon aufgenommen. D.h. meine Schreiberei war nicht komplett umsonst – fehlt noch das Impressum (copy&paste) und die about-Site (ok, und 2 Einträge in den FAQs). Oh Mann!
Inkompetenz und so
Momentan entwickle ich für dieses Blog ein Template, weil ich gerne was eleganteres, übersichtlicheres und überhaupt – individuelleres hätte. So gut so schlecht. Dabei stoße ich auf Dinge, die so, wie ich sie will, nicht funktionieren. Okay, garkein Problem – ist ja OpenSource…
Nur ist dieses System und die API äußerst grauenhaft dokumentiert! Man muss sich erstmal durch zig Seiten hangeln – aber das, was man sucht, findet man nicht. Es gibt Systeme für API-Dokumentation! Man muss sie nur nutzen! Verdammt, so schwer ist das auch nicht!!!!!!!!!!!!!!!!!!!!!!!!!!
Was bitte ist in der Variable $content enthalten, die gerne von Plugins als Parameter, der aufgerufen wird, verwendet wird?! Kann man sinnvoll z.B. die Post-ID rausziehen? Gibt es etwa eine Funktion get_PostID, die man an ein Plugin übergeben kann? Und überhaupt: wo ist die ominöse Dokumentation, die beschreiben soll, welche Variablen etc. übergeben werden können? Genau: nirgendwo. Schon garnicht verlinkt. So geht das nicht!!!
Zwei Worte zur Inline-Doku: ist ja recht schön und gut, aber: es nützt genau garnichts, wenn nur unvollständig dokumentiert ist, und man ihn sich trotzdem den SourceCode durchlesen muss (was bei großen PHP-Projekten nunmal !Spaß bedeutet). Das ist nicht Sinn und Zweck einer Inline-Dokumentation. Das ist Psychogeschwafel “wir haben eine Inline-Doku” – beruhigt das Gewissen, nützt aber nicht!
Also: schreibt verdammte Doku. Eine Developer-Doku für Plugin-Developer, für Template-Developer und eine für WordPress-Developer. Wobei man Plugin und WordPress u.U. zusammenschmeissen könnte. Oder auch nicht. Aber beschreibt verdammt nochmal sauber, welche returning-Values es gibt. Welche Parameter an welche Funktion übergeben werden können/sollen/müssen. Wie z.B. die Class Library der MSDN! Sowas ist sauber – ein gutes Beispiel der System.Xml-Namespace. Und sauber verlinken. Danke! So klappt das auch mit “Informationen finden”, wenn jemand ein Plugin (welches eigentlich ganz einfach (5 Zeilen SourceCode) wäre) entwickeln möchte – ohne ewig suchen zu müssen!!!
Obskure Bugs
Wo ich grade so schön in Rage bin: Das UTW3-Plugin ist – seltsam. Nicht nur, dass es in einem mit logischen Mitteln nicht nachvollziehbaren Chaos endete, sondern auch noch, dass es mehrere Anläufe benötigt, um zu funktionieren.
- Problem 1 war: nicht nach vergebenen Tags durchsuchbar. Nebenan klappt das aber mit der selben Configuration, nur anderes Blog.
- Problem 2 war: Permalinks werden nur in einer bestimmten (nirgendwo dokumentiert wie/wie nicht das klappt) Anordnung akzeptiert. Wie? – Weiß ich nicht so genau…
- Problem 3 war: die Pages werden irgendwie verhunzt. Soll heißen: man erhält einen 404 bei den Pages.
Des Rätsels Lösung (vorsicht, Angabe ohne Gewähr) scheint zu sein, dass man erst die Einstellungen am UTW3-Plugin vornehmen muss, anschließend im Options-Menü unter Permalink “Update PermalinkStructure” klicken muss… Fragt mich nicht.
Fazit der vergangenen Tage
Genau, ich lass’ mal Bart sprechen:
Es sind dabei zwei Dinge entstanden:
- Template: green solar corona: 2 columns, widget-ready, ca. 50 kb [download]
- Plugin: List all categories, ca. 684 byte [download]
Zwei Worte zum Template: es benötigt per default die Plugins ‘list all categories’, und ‘get recent comments’.
Zwei Worte zum Plugin: im SourceCode bitte die PostID (steht im WordPress unter ‘ID’ auf der Manage-Pages-Seite) der ‘Page’, die zur Anzeige der Categories verwendet werden soll, angeben. Parameter, welche von wp_list_categories() akzeptiert werden, bitte in der Doku nachlesen und entsprechend einbauen.
Ach ja: wer ein Beispiel haben will, wie ‘green solar corona’ aussieht, sollte sich aufmerksam auf diesem Blog umsehen: das Template wird von mir verwendet 