<\/p>\n
zdalne publikowanie?<\/h3>\n
Ju\u017c od bardzo dawna w WordPressie zosta\u0142a wprowadzona opcja publikowana przez specjalnie za\u0142o\u017con\u0105 skrzynk\u0119 mailow\u0105. Przyznam szczerze, \u017ce nie przygl\u0105da\u0142em si\u0119 jej szczeg\u00f3\u0142owo, ale g\u0142\u00f3wna idea polega na publikowaniu tre\u015bci ka\u017cdego listu, kt\u00f3ry na ni\u0105 dotrze. Je\u015bliby chcie\u0107 regularnie publikowa\u0107 z poziomu jakiego\u015b wi\u0119kszego skryptu, to jest to jednak rozwi\u0105zanie okr\u0119\u017cne, kt\u00f3re – w dodatku – wymaga skorzystania z dodatkowego po\u015brednika. Je\u015bli padnie poczta, to klops -nie da si\u0119 publikowa\u0107 wpis\u00f3w.<\/p>\n
Niekt\u00f3rzy szukaj\u0105 jakich\u015b materia\u0142\u00f3w po prostu po terminie API<\/em>. Niestety, w wi\u0119kszo\u015bci wynik\u00f3w s\u0105 opisane funkcje WordPressa dla wtyczek. Owszem, na upartego mo\u017cna by tak\u0105 napisa\u0107 i np. pobiera\u0107 tre\u015b\u0107 z jakiego\u015b pliku co jaki\u015b czas. Tylko po co tak kombinowa\u0107…? Poza tym – rozwi\u0105zanie jest bardziej obej\u015bciem, poniewa\u017c mo\u017cna bezpo\u015brednio „nakaza\u0107” silnikowi blogowemu publikacj\u0119 notki.<\/p>\n W\u0142a\u015bciwie, to od samego (dobrze pami\u0119tam?) pocz\u0105tku istnienia WordPress zawiera\u0142 odpowiedni modu\u0142 do obs\u0142ugi zapyta\u0144 XML-RPC. Pewnie wielu z Was si\u0119 zastanawia\u0142o, co to za tajemniczy plik xmlrpc.php<\/em> odbiegaj\u0105cy od typowej konwencji nazw wp-co\u015btam<\/em>. Co to jest XML-RPC? Jest to pseudoprotok\u00f3\u0142 dzia\u0142aj\u0105cy po HTTP, kt\u00f3rego sk\u0142adnia jest oparta na XML-u oraz nazwach funkcji obs\u0142uguj\u0105cego silnika. Skrypt korzystaj\u0105cy z odpowiedniej biblioteki jest w stanie pracowa\u0107 jako serwer oraz klient – nie ma ogranicze\u0144; to wywo\u0142anie oraz spos\u00f3b napisania danej aplikacji okre\u015bla, co i jak ma zosta\u0107 wykonane. Dialog klienta z serwerem mo\u017cna por\u00f3wna\u0107 do zdalnego wywo\u0142ania funkcji z danego j\u0119zyka programowania. Warstwa XML-RPC dba o to, aby odpowiednio zakodowa\u0107 nazw\u0119 metody oraz przesy\u0142ane informacje.<\/p>\n Na jednej ze stron<\/a> Codexu<\/a> silnika jest dost\u0119pny rozdzia\u0142 opisuj\u0105cy metody, kt\u00f3re mo\u017cna wywo\u0142a\u0107 za po\u015brednictwem XML-RPC w WordPressie. Tak naprawd\u0119 tw\u00f3rcy postanowili wykorzysta\u0107 kilka popularnych „dialekt\u00f3w” w celu zwi\u0119kszenia kompatybilno\u015bci z ju\u017c istniej\u0105cymi aplikacjami\/bibliotekami s\u0142u\u017cacymi do publikacji tre\u015bci bez po\u015brednictwa przegl\u0105darki. Aby w pe\u0142ni wykorzysta\u0107 mo\u017cliwo\u015bci WP, developerzy postanowili utworzy\u0107 dodatkowe funkcje, kt\u00f3rych nie udost\u0119pniaj\u0105 inne silniki. S\u0105 to zazwyczaj funkcje dotycz\u0105ce obs\u0142ugi komentarzy, autor\u00f3w, kategorii, czy metody umo\u017cliwiaj\u0105ce przesy\u0142anie plik\u00f3w. Je\u015bli nazwy metod r\u00f3\u017cni\u0105 si\u0119 tylko nazwami API (inny prefiks), developerzy zalecaj\u0105 korzystanie z funkcji umieszczonych w przestrzeni nazw wp.<\/em>.<\/p>\n Owszem, mo\u017cna by by\u0142o bezpo\u015brednio do\u0142\u0105czy\u0107 do skryptu biblioteki WP, ale czy to ma sens? Po co \u015bmieci\u0107 skrypty, niepotrzebnie z\u017cera\u0107 pami\u0119\u0107? Poza tym, nie ma mo\u017cliwo\u015bci dodania wpis\u00f3w na innym fizycznym serwerze. Wi\u0119c idealnym rozwi\u0105zaniem jest XML-RPC.<\/p>\n Najwa\u017cniejszym elementem jest biblioteka, kt\u00f3ra b\u0119dzie kodowa\u0142a dane do formatu \u017c\u0105dania XML-RPC. Mo\u017cna j\u0105 napisa\u0107 samodzielnie (jest dost\u0119pna specyfikacja formatu<\/a>) albo skorzysta\u0107 z wielu gotowych. PHP posiada natywne rozszerzenie, kt\u00f3re mo\u017cna dokompilowa\u0107, ale jego u\u017cycie jest jednak nieintuicyjne. B\u0119dzie jednak szybsze (gdy\u017c jest cz\u0119\u015bci\u0105 interpretera).<\/p>\n Z racji tego, i\u017c natywne rozszerzenie XML-RPC nie jest wsz\u0119dzie dost\u0119pne, mo\u017cna pos\u0142u\u017cy\u0107 si\u0119 bibliotek\u0105 XML-RPC for PHP<\/a>. Jest ona aktualizowana, co w przypadku niekt\u00f3rych jest sporym problemem. Dodatkowo, w paczce znajduje si\u0119 obszerna dokumentacja oraz przyk\u0142ady.<\/p>\n Ja skorzystam z tego, co daje WordPress. W katalogu wp-includes<\/em> znajduje si\u0119 plik class-IXR.php<\/em>. To w\u0142a\u015bnie ona si\u0119 nam przyda. Skupi\u0119 si\u0119 na samej publikacji wpisu, o to g\u0142\u00f3wnie przecie\u017c chodzi. [;<\/p>\n Pierwszym krokiem jest uaktywnienie XML-RPC w WordPressie. Wystarczy otworzy\u0107 opcje<\/em>, publikacja<\/em> i w\u0142\u0105czy\u0107 protoko\u0142y publikowania XML-RPC<\/em>. Zacznijmy od szkieletu naszego prostego skryptu. Sprawdzimy nim, czy nasz skrypt prawid\u0142owo si\u0119 komunikuje z WordPressem:<\/p>\n echo $q->getResponse(); Powy\u017cszy kod powinien zwr\u00f3ci\u0107 Hello<\/em>, co oznacza, \u017ce komunikacja z WP przebiega prawid\u0142owo. I teraz kilka s\u0142\u00f3w wyja\u015bnie\u0144, pomimo \u017ce kod do zbyt skomplikowanych nie nale\u017cy. Sprawd\u017amy autoryzacj\u0119, wy\u015bwietlmy kategorie u\u017cywane na blogu. Dane zwr\u00f3cone przez t\u0119 metod\u0119 przydadz\u0105 si\u0119 do wstawiania nowej notki.<\/p>\n var_dump($q->getResponse()); W odpowiedzi otrzymamy np. to:<\/p>\n Ok, komunikacja dzia\u0142a, nazwy te\u017c mamy, pora na w\u0142a\u015bciw\u0105 publikacj\u0119. Skorzystamy z protoko\u0142u<\/a> opracowanego na potrzeby Blogger Google’a.<\/p>\n var_dump($q->getResponse()); Parametr przed identyfikatorem bloga, to „zg\u0142oszenie” aplikacji. Jest to wymagane tylko dla macierzystej us\u0142ugi i w naszym przypadku mo\u017ce to by\u0107 dowolny ci\u0105g znak\u00f3w. Powy\u017cszy kod dodaje notk\u0119 o tre\u015bci hello World!<\/em>, bez tytu\u0142u i innych metadanych. Aby doda\u0107 tytu\u0142, kategori\u0119, czy ustawi\u0107 zajawk\u0119, skorzystamy z metaWeblogApi<\/a>, a dok\u0142adniej metody metaWeblog.newPost<\/em>. Je\u015bli chodzi o jej parametry, to wystarcz\u0105 typowe – nazwa metody, ID bloga, login, has\u0142o, dane notki oraz status wpisu (czy publikowa\u0107, czy zapisa\u0107 jako brudnopis).<\/p>\n Najwa\u017cniejsza jest w tym przypadku konstrukcja, kt\u00f3r\u0105 nazwa\u0142em danymi notki. Nie jest to nic innego, jak tablica asocjacyjna, kt\u00f3ra zawiera kilka kluczy. ;] Struktura posiada prawie identyczn\u0105 konstrukcj\u0119, co pole wpisu w specyfikacji RSS 2.0<\/a> poszerzone o kilka p\u00f3l. Koniec owijania w bawe\u0142n\u0119, pora publikowa\u0107.<\/p>\n if(!$q->query('metaWeblog.newPost', 1, 'admin', '*********', $note, true)){ var_dump($q->getResponse()); Jak zwykle, metoda getResponse<\/em> po pomy\u015blnym dodaniu notki, zwr\u00f3ci ID wpisu. Wpis zosta\u0142 opublikowany. ;]<\/p>\n PS: niestety, nie uda\u0142o mi si\u0119 zmusi\u0107 WordPressa do ustawienia konkretnej daty publikacji wpisu. Z komunikat\u00f3w wynika, \u017ce jest jaki\u015b b\u0142\u0105d w WordPressie.<\/p>\n Przyda\u0142oby si\u0119 jeszcze pobra\u0107 link do notki:<\/p>\n var_dump($q->getResponse()); Gdzie 3<\/em>, to ID notki. Warto\u015b\u0107 zwr\u00f3cona przez getResponse<\/em> to tablica, kt\u00f3ra zawiera kilka ciekawych informacji. Ale jakich? To ju\u017c zadanie domowe. [;<\/p>\n Podpowiem tylko, \u017ce w celu pobrania bezpo\u015bredniego linka do notki wystarczy:<\/p>\n WordPress jest ciekaw\u0105 platform\u0105 do publikacji r\u00f3\u017cnego rodzaju tre\u015bci. Tak naprawd\u0119, z silnika blogowego zrodzi\u0142 si\u0119 potw\u00f3r, kt\u00f3ry na wielu polach nie ust\u0119puje CMS-om z prawdziwego zdarzenia, takim jak np. Drupal, czy Joomla. Tylko od zestawu wtyczek i inwencji u\u017cytkownika zale\u017cy, co i jak b\u0119dzie publikowane, a WordPress zadba o reszt\u0119.<\/p>\nXML-RPC<\/h3>\n
komunikacja<\/h3>\n
query('demo.sayHello')){
\n echo $q->getErrorCode().': '.$q->getErrorMessage();
\n}<\/p>\n
\n?><\/code><\/p>\n![\";)\"](\"https:\/\/eriz.pcinside.pl\/weblog\/wp-includes\/images\/smilies\/e_wink.png\")
W konstruktorze klasy IXR_Client<\/em> wstawiamy URL do pliku xmlrpc.php<\/em> naszego bloga. G\u0142\u00f3wn\u0105 funkcj\u0105, kt\u00f3ra powoduje wykonanie danego \u017c\u0105dania jest query<\/em>. Jako pierwszy parametr przyjmuje ona nazw\u0119 metody udost\u0119pnianej przez serwer. Pozosta\u0142e (opcjonalne parametry), to jej argumenty. S\u0105 one opisane w dokumentacji, wystarczy je po prostu poda\u0107 po przecinku. Przy wi\u0119kszo\u015bci wywo\u0142a\u0144 funkcji WP b\u0119dziemy podawali co najmniej 4 parametry – nazw\u0119 metody, identyfikator bloga, login i has\u0142o do panelu. Je\u015bli nie mamy kilku dziennik\u00f3w skonfigurowanych dla jednego skryptu (WordPress Multi User), b\u0119dzie to po prostu dowolna warto\u015b\u0107. List\u0119 blog\u00f3w oraz ich identyfikatory uzyskamy wywo\u0142uj\u0105c wp.getUsersBlogs<\/em>. W\u00f3wczas bez identyfikatora, rzecz jasna. [;<\/p>\nquery('wp.getCategories', 1, 'admin', '*********')){
\n echo $q->getErrorCode().': '.$q->getErrorMessage();
\n}<\/p>\n
\n?><\/code><\/p>\narray
\n 0 =>
\n array
\n 'categoryId' => string '1' (length=1)
\n 'parentId' => string '0' (length=1)
\n 'description' => string 'Uncategorized' (length=13)
\n 'categoryName' => string 'Uncategorized' (length=13)
\n 'htmlUrl' => string 'http:\/\/127.0.0.2\/php\/wordpress\/?cat=1' (length=37)
\n 'rssUrl' => string 'http:\/\/127.0.0.2\/php\/wordpress?feed=rss2&cat=1' (length=50)<\/code><\/p>\nprosta publikacja<\/h3>\n
query('blogger.newPost', 'asd', 1, 'admin', '*******', 'hello World!', true)){
\n echo $q->getErrorCode().': '.$q->getErrorMessage();
\n}<\/p>\n
\n?><\/code><\/p>\n 'Hello World!', \/\/tytu\u0142
\n 'description' => 'to b\u0119dzie wst\u0119p...', \/\/zajawka
\n 'mt_text_more' => 'tre\u015b\u0107 wpisu', \/\/tre\u015b\u0107
\n 'categories' => array('Uncategorized'), \/\/nazwy kategorii jako elementy tablicy
\n 'mt_keywords' => array('tag1', 'tag2', 'tag'), \/\/ tagi
\n \/\/'dateCreated' => date(DATE_RFC822, mktime(0, 0, 0, 1, 1, 2000)), \/\/data publikacji wpisu
\n \/\/'wp_password' => 'hasuo', \/\/has\u0142o wpisu
\n \/\/'mt_allow_pings' => true, \/\/zezwala\u0107 na pingbacki?
\n \/\/'mt_allow_comments' => true, \/\/a na komentarze?
\n);<\/p>\n
\n echo $q->getErrorCode().': '.$q->getErrorMessage();
\n}<\/p>\n
\n?><\/code><\/p>\npo publikacji<\/h3>\n
query('metaWeblog.getPost', 3, 'admin', '******')){
\n echo $q->getErrorCode().': '.$q->getErrorMessage();
\n}<\/p>\n
\n?><\/code><\/p>\ngetResponse();
\necho $d['permaLink'];
\n?><\/code><\/p>\nepilog<\/h3>\n