From 058971c33b8dca63fd33b188328fc3e3ec9fb372 Mon Sep 17 00:00:00 2001 From: Dries Buytaert Date: Fri, 3 Oct 2003 14:55:27 +0000 Subject: - Help improvements and translation improvements from Michael. Thanks! --- modules/bloggerapi.module | 22 +++++++++++----------- 1 file changed, 11 insertions(+), 11 deletions(-) (limited to 'modules/bloggerapi.module') diff --git a/modules/bloggerapi.module b/modules/bloggerapi.module index 7c185e7f7..ff4c21fec 100644 --- a/modules/bloggerapi.module +++ b/modules/bloggerapi.module @@ -348,31 +348,31 @@ function bloggerapi_help($section) { case 'admin/bloggerapi/help': case 'admin/help': $output = "

Introduction

"; - $output .= strtr("

%blogger-com, the well-known public weblog service, provides an application programing interface (API) to allow remote procedure calls (RPC) to the Blogger service. Drupal supports this %blogger-api, which means that many remote clients (e.g. %client-radio, %client-blogbuddy, %client-w_bloggar, and %client-textrouter) may post to Drupal. These clients provide a bevy of interesting capabilities like offline composing, spellcheck, and WYSIWYG editing; many folks prefer to blog with a client application over typical web forms. By supporting the Blogger API, Drupal grows grander than a web site engine, it's a content accepting machine™.

", array("%blogger-com" => "". t("Blogger") ."", "%blogger-api" => "". t("Blogger API") ."", "%client-radio" => "". t("Radio") ."", "%client-blogbuddy" => "". t("BlogBuddy") ."", "%client-w_bloggar" => "". t("w.bloggar") ."", "%client-textrouter" => "". t("TextRouter") ."" )); - $output .= strtr("

The %blogger-api uses the %xml-rpc protocol for communicating with the outside world. %xml-rpc, originally developed by Dave Winer of %userland-software, is a simple XML-based RPC specification ideally suited to the web. Drupal also uses %xml-rpc for several other tasks (e.g. notifiying %weblogs-com of blog updates and making/accepting %dist-auth requests)

",array("%blogger-api" => "". t("Blogger API") ."", "%xml-rpc" => "". t("XML-RPC") ."", "%userland-software" => "". t("UserLand Software") ."", "%weblogs-com" => "". t("weblogs.com") ."", "%dist-auth" => l(t("distributed authentication"), "user/help") )) ; + $output .= "

%blogger-com, the well-known public weblog service, provides an application programing interface (API) to allow remote procedure calls (RPC) to the Blogger service. Drupal supports this %blogger-api, which means that many remote clients (e.g. %client-radio, %client-blogbuddy, %client-w_bloggar, and %client-textrouter) may post to Drupal. These clients provide a bevy of interesting capabilities like offline composing, spellcheck, and WYSIWYG editing; many folks prefer to blog with a client application over typical web forms. By supporting the Blogger API, Drupal grows grander than a web site engine, it's a content accepting machine™.

"; + $output .= "

The %blogger_api uses the %xml-rpc protocol for communicating with the outside world. %xml-rpc, originally developed by Dave Winer of %userland-software, is a simple XML-based RPC specification ideally suited to the web. Drupal also uses %xml-rpc for several other tasks (e.g. notifiying %weblogs-com of blog updates and making/accepting %dist-auth requests)

"; $output .= "

Blogger API implementation

"; - $output .= strtr("

A word of warning on the Blogger API: it is unofficial. It exists because Blogger is one of the most popular and the first service to implement an XML-RPC interface. It may not be the best implementation of a distributed weblog API. For a promising candidate, see the %echo-proj.

", array("%echo-proj" => "". t("Echo project") ."" )); + $output .= "

A word of warning on the Blogger API: it is unofficial. It exists because Blogger is one of the most popular and the first service to implement an XML-RPC interface. It may not be the best implementation of a distributed weblog API. For a promising candidate, see the %echo-proj.

"; $output .= "

Drupal's support for the Blogger API is quite complete. Each method with an asterisk below has been implemented in Drupal.

"; - $output .= strtr("

%bloggerapi-newpost
%bloggerapi-editpost
%bloggerapi-getuserblogs
%bloggerapi-getuserinfo
%bloggerapi-gettemplate
%bloggerapi-settemplate

", array("%bloggerapi-newpost" => "%blogger-api/xmlrpc_newPost.html\">". t("blogger.newPost()*") ."", "%bloggerapi-editpost" => "%blogger-api/xmlrpc_editPost.html\">". t("blogger.editPost()*") ."", "%bloggerapi-getuserblogs" => "%blogger-api/xmlrpc_getUserBlogs.html\">". t("blogger.getUsersBlogs()*") ."", "%bloggerapi-getuserinfo" => "%blogger-api/xmlrpc_getUserInfo.html\">". t("blogger.getUserInfo()*") ."", "%bloggerapi-gettemplate" => "%blogger-api/xmlrpc_getTemplate.html\">". t("blogger.getTemplate()*") ."", "%bloggerapi-settemplate" => "blogger-api/xmlrpc_setTemplate.html\">". t("blogger.setTemplate()*") ."" )); - $output = strtr($output, array("%blogger-api" => "%mess-296
%mess-225
%mess-147

", array("%mess-296" => "%blogger-dev/296\">". t("blogger.getPost()*") ."", "%mess-225" => "%blogger-dev/225\">". t("blogger.getRecentPosts()*") ."", "%mess-147" => "%blogger-dev/147\">". t("blogger.deletePost()*") ."" )); - $output = strtr($output, array("%blogger-dev" => "To install the Blogger API module, enable the module on the %mod-config. Also make sure you have your permissions set correctly for accessing the Blogger API, the relevant settings can be found under the %user-management section in the administration pages. Check the checkbox behind the line \"access Blogger API\" for the roles that are allowed to use the Blogger API.

", array("%mod-config" => l(t("modules configuration page"), "admin/systems/modules"), "%user-management" => l(t("user management"), "admin/user/permission") )); + $output .= "

To install the Blogger API module, enable the module on the %mod-config. Also make sure you have your permissions set correctly for accessing the Blogger API, the relevant settings can be found under the %user-management section in the administration pages. Check the checkbox behind the line \"access Blogger API\" for the roles that are allowed to use the Blogger API.

"; $output .= "

Once the API is enabled you can download one of the above mentioned Blogger API clients and get blogging.

"; $output .= "

Setup of the client

"; - $output .= strtr("

The Drupal page you need to call in order to connect using the Blogger API is http://server/xmlrpc.php where server is the URL of the site you want to post to. As an example when posting to drupal.org, the account settings for %client-wbloggar would be: host: www.drupal.org (default = plant.blogger.com) and page: xmlrpc.php (default = /api/RPC2).

", array("%client-wbloggar" => "". t("w.bloggar") ."" )); + $output .= "

The Drupal page you need to call in order to connect using the Blogger API is http://server/xmlrpc.php where server is the URL of the site you want to post to. As an example when posting to drupal.org, the account settings for %client-w_bloggar would be: host: www.drupal.org (default = plant.blogger.com) and page: xmlrpc.php (default = /api/RPC2).

"; $output .= "

You can't use remote authentication when posting using a Blogger API enabled client, even when you could use that to authenticate on the site itself. You will have to use the site's local username, enter a password for that account, and then use that combination to post using the Blogger API client.

"; $output .= "

Notes and limitations

"; $output .= ""; + $output = t($output, array("%blogger-com" => "Blogger", "%blogger_api" => "%blogger-api\">Blogger API", "%client-radio" => "Radio", "%client-blogbuddy" => "BlogBuddy", "%client-w_bloggar" => "w.bloggar", "%client-textrouter" => "TextRouter", "%xml-rpc" => "XML-RPC", "%userland-software" => "UserLand Software", "%weblogs-com" => "weblogs.com", "%dist-auth" => l(t("distributed authentication"), "user/help"), "%echo-proj" => "". t("Echo project") ."", "%bloggerapi-newpost" => "%blogger-api/xmlrpc_newPost.html\">blogger.newPost()*", "%bloggerapi-editpost" => "%blogger-api/xmlrpc_editPost.html\">blogger.editPost()*", "%bloggerapi-getuserblogs" => "%blogger-api/xmlrpc_getUserBlogs.html\">blogger.getUsersBlogs()*", "%bloggerapi-getuserinfo" => "%blogger-api/xmlrpc_getUserInfo.html\">blogger.getUserInfo()*", "%bloggerapi-gettemplate" => "%blogger-api/xmlrpc_getTemplate.html\">blogger.getTemplate()*", "%bloggerapi-settemplate" => "%blogger-api/xmlrpc_setTemplate.html\">blogger.setTemplate()*", "%mess-296" => "%blogger-dev/296\">blogger.getPost()*", "%mess-225" => "%blogger-dev/225\">blogger.getRecentPosts()*", "%mess-147" => "%blogger-dev/147\">blogger.deletePost()*","%mod-config" => l(t("modules configuration page"), "admin/systems/modules"), "%user-management" => l(t("user management"), "admin/user/permission") )); + $output = strtr($output, array("%blogger-api" => " " -- cgit v1.2.3