Textpattern Links
- Textpattern Site: Main textpattern site. Don't forget to visit it for updates and news.
- Textpattern Forum: The place where the discussion takes place. Find other textpattern users help here and at the #textpattern channel on irc.feenode.net.
- TextBook: The authoritative user manual for Textpattern. The better site to find documentation about Textpattern.
- Textpattern Resources: A directory of plugins, tutorials, templates, and other resources for and by the Textpattern Community.
XML-RPC API
- Blogger API
- blogger.getUserInfo
- blogger.newPost
- blogger.getUserBlogs
- blogger.editPost
- blogger.getTemplate
- blogger.setTemplate
- blogger.getPost
- blogger.getRecentPosts
- blogger.deletePost
- MetaWeblog XML-RPC API
- metaWeblog.newPost
- metaWeblog.getPost
- metaWeblog.editPost
- metaWeblog.getRecentPosts
- metaWeblog.getCategories
- MovableType XML-RPC API
- mt.supportedMethods
- mt.supportedTextFilters
- mt.getCategoryList
- mt.getPostCategories
- mt.setPostCategories
Textpattern XML-RPC API
# 11 04 2005 - 17:09 #
This document describes the XML-RPC programmatic interfaces implemented by Textpattern XML-RPC server1.
Textpattern provides support for the most extended XML-RPC blog APIs. This means:
- Full support of the BloggerAPI – and the unofficial BloggerAPI2.
- Full support of the MetaWeblogAPI
- Support when possible for MovableTypeAPI
TXP_RPCServer is built on top of Simon Willison’s XML-RPC IXR Library, providing an Introspection server, which is able to answer clients about the public methods it implements.
You can get a list of all the system supported methods programmatically using either the RPC methods system.listMethods and mt.supportedMethods . The XML-RPC server implementation is also able to retrieve a list of supported capabilities using the method system.getCapabilities .
The Blogger API
Textpattern XML-RPC server supports the whole Blogger XML-RPC API with some assumptions:
- The appkey is not needed, so you can provide anything on this parameter.
- Textpattern has no different blogs, but different sections. Each section is treated as a different blog, with its own articles – or posts, if you prefer.
General information about Textpattern implementation of Blogger API XML-RPC
Blogger API supported methods:
- blogger.getUserInfo
- blogger.getUserBlogs
- blogger.newPost
- blogger.editPost
- blogger.getTemplate
- blogger.setTemplate
- blogger.getPost
- blogger.getRecentPosts
- blogger.deletePost
Metaweblog API
The method metaWeblog.newMediaObject isn’t supported – and it will be not in the future, due to the vastly mayory of XML-RPC clients are able to upload files using built in FTP clients.
General information about Textpattern implementation of MetaWeblog API XML-RPC
Metaweblog API supported methods
- metaWeblog.newPost
- metaWeblog.editPost
- metaWeblog.getPost
- metaWeblog.getRecentPosts
- metaWeblog.getCategories
MovableType API
TXP-RPC server implements some methods of the MovableType API.
The method mt.getTrackbackPings is not supported, since Textpattern doesn’t implements TrackBack. mt.publishPost is supported only to silence some clients errors, since it has sense for software which requires file rebuilds, but not for a dyamic one, like textpattern.
General information about Textpattern implementation of Movable Type API XML-RPC
MovableType API supported methods
- mt.supportedMethods
- mt.supportedTextFilters
- mt.getCategoryList
- mt.getPostCategories
- mt.setPostCategories
1 TXP_Wrapper
All these interfaces access Textpattern DataBase through a wrapper class called TXP_Wrapper, which takes care about things like user validation, privileges and data process before to add it to the Textpattern DB.
Main goal of this class is to keep API implementations focused on the task they undertake, without worry about how data should be formated before to be inserted or retrieved from the Textpattern DB, in function of User Preferences.
We strongly recommend to all Textpattern API developers to use this class with their applications.
The class is not only intended to be used with XML related APIs, but from any application which has access with Textpattern Data, like a moblogging client and so on.