Erhalten Sie eine Peer Review für mein neues Plugin?

Was ist der beste Weg, um einen erfahrenen WordPress-Entwickler dazu zu bringen, sich mein Plugin anzusehen und konstruktive Kritik zu üben? Ich habe Code geschrieben, um einige meiner Fragen auf dieser Site zu lösen, und ich denke, sie könnten auch für andere nützlich sein. Da sie jedoch von meinen ersten öffentlichen WordPress-Plugins stammen und ich viele nicht so gute Beispiele im öffentlichen WordPress-Verzeichnis gesehen habe, möchte ich wissen, "wo ich stehe" und wie ich meine Plugins verbessern kann. Ich habe die Liste der Best Practices gelesen und muss noch einige davon anwenden, möchte aber auch eine Antwort auf die allgemeinere Frage "Ist dies ein guter Weg, um dieses Problem zu lösen?"

Ich habe gerade die entsprechende Diskussion überwp-hackers erneut gelesen (ich wusste nicht, dass die Teilnehmer auch so an dieser Site beteiligt waren und dass die Frage nach den "Best Practices" ein direktes Ergebnis davon ist). Ich bin nicht sicher, ob meine Bedürfnisse durch ein solches System abgedeckt werden, und ich stimme den Bedenken von Paul zu :

Als ich letzte Woche die ursprünglichen Kommentare zu diesem Thread las, dachte ich, dass der Zweck darin bestand, einen Peer-Review-Prozess zusammenzustellen, bei dem Plugin-Entwickler anderen Plugin-Entwicklern Ratschläge zur Überprüfung ihres Codes geben können. Ich habe diesen Rat ursprünglich wie folgt verstanden: "Nun, Ihr Code funktioniert, aber diese von Ihnen geschriebenen Routinen wären besser geeignet, wenn Sie sich nur in diesen WP-Filter einbinden und diese Technik ausprobieren würden (siehe xxx-Plugin als Beispiel). ". Das Ziel, das ich dachte, war es, das Wissen über die Entwicklung von WP-Plugins zu teilen und jeden mittelmäßigen Plugin-Entwickler zu einem besseren Entwickler zu machen. Wie ich.

Dies wäre ein anderer Umfang als eine Punkt-für-Punkt-Überprüfung der Checkliste, es wäre eher eine "Mentorschaft". Es scheint, dass es viele Menschen gibt, die dazu bereit sind, und (noch besser) viele von ihnen nehmen hier auf dieser Website teil. Wie können wir also all diese Energie in etwas Konkretes umwandeln?

Mein aktuelles Beispiel sind drei Plugins, die ich geschrieben habe, um mein Problem mit der Bildgröße zu lösen . Ich habe zu jedem Plugin lange einleitende Kommentare geschrieben, was (ich hoffe) es einfacher macht, meine Absichten zu verstehen, ohne den vollständigen Code zu lesen. Kann ich noch etwas tun, um es anderen leichter zu machen, es sich anzusehen? Bitte ignorieren Sie meine aktuelle konkrete Anfrage. Es ist nicht nur zu früh für sie, sondern ich habe meine Meinung geändert und möchte die allgemeine Diskussion mit meiner spezifischen Situation nicht verderben.

Der einfachste Weg ist ein zweistufiger Ansatz:

1. Geben Sie Ihr Plug-In für die Öffentlichkeit frei. Sobald es live ist, erhalten Sie neben Entwicklern auch Feedback von Endbenutzern. Wenn Sie möchten, veröffentlichen Sie es als "Beta" -Version und betonen Sie dies in der Readme-Datei.
2. Fragen. Überall gibt es erfahrene WordPress-Entwickler: hier, auf der WP-Hackers-Liste, bei WordPress-Jobs , bei @wordpress auf Twitter usw. Es geht nur darum, Ihr Plug-In rauszuwerfen und um Feedback zu bitten.

Befolgen Sie im Allgemeinen die gleichen Schritte, als würden Sie einen Core-Patch von einem Entwickler betrachten lassen:

• Schreib es
• Dokumentieren Sie es
• Wenden Sie sich an einen Entwickler (entweder über einen der oben genannten Kanäle oder direkt, wenn Sie können) und bitten Sie um Feedback

Was die Umwandlung der Art von "Mentoring" an dieser Stelle in etwas Konkreteres angeht, wäre dies ein organischer Prozess. Wie Sie bereits erwähnt haben, scheinen die Bemühungen, eine Art Plug-In-Überprüfungsprozess zu erstellen, bevor tatsächlich etwas überprüft wird, ins Stocken geraten zu sein. Die einzige Möglichkeit, etwas in Gang zu bringen, besteht darin, tatsächlich damit zu beginnen. Sprechen Sie also nicht nur darüber, einen erfahrenen Entwickler zu finden und Feedback zu erhalten, sondern gehen Sie hinaus, finden Sie einen, holen Sie sich Ihr Feedback und schreiben Sie auf, wie der Prozess verlaufen ist.

Dann kann es mit zukünftigen Plug-Ins und zukünftigen Entwicklern wiederholt werden. Aber du musst irgendwo anfangen ...

Nach einem kurzen Blick auf https://gist.github.com/675437 sah ich einige kleinere Punkte, hauptsächlich in Bezug auf die Lesbarkeit:

• Schreiben Sie eine gute Codedokumentation: Docblocks… und Inline-Kommentare, wenn etwas nicht absolut klar ist.
• Teilen Sie lange Funktionen in kürzere separate Funktionen auf. Sie sind leichter zu lesen und in den Kommentaren der Rezensenten zu behandeln.
• Richten Sie Ihre Zuweisungsoperatoren aus und fügen Sie Leerzeichen zwischen Klammern ein.
• 80 Zeichen Zeilenlänge bitte! Eclipse kann immer noch keine langen Zeilen umbrechen. :(
• Halten Sie Ihren Code »links«, speichern Sie Einrückungen. Anstatt:

.  

public function checkUrl()
{
    if (is_404()) {
        // code
    }
}

… schreiben …

public function checkUrl()
{
    if ( ! is_404() ) {
        return;
    }
    // code
}

Ich habe gerade heute Abend ein neues Plugin geschrieben… und ich habe mich gefragt, ob ich genau Ihre Frage stellen darf. Gutes Timing. :) :)

Ich musste nur an Appscan denken: http://www01.ibm.com/software/rational/products/appscan/source/ ; http://www-01.ibm.com/software/rational/products/appscan/source/features/ Testversion der Light-Version: http://www-01.ibm.com/software/awdtools/appscan/express/

Dies kann PHP tun und man kann zusätzliche Regeln einfügen, um nach Dingen zu suchen. Auf diese Weise kann ein Teil automatisiert werden (wie einige Best Practices wie in der Antwort von toscho), es kann nach Sicherheit, Codierungsstandards, Optimierungen usw. suchen.

Ich sage nur: Wenn ein Werkzeug 80% prüfen kann, sind die 20% für die manuellen Prüfungen für einen Guru geringer. Es wäre auch hilfreich, Compliance-Berichte für die Verwendung eines Plugins in einem großen Unternehmen zu erstellen, das solche Anforderungen an zusätzlichen Code stellt.

Wir automatisieren Dinge für andere Menschen. Warum also nicht für uns selbst?