root/branches/release-26/lib/MT/XMLRPCServer.pm @ 1174

Revision 1174, 45.0 kB (checked in by bchoate, 23 months ago)

Updated copyright year for source.
  • Property svn:keywords set to Author Date Id Revision
Line 
1# Movable Type (r) Open Source (C) 2001-2008 Six Apart, Ltd.
2# This program is distributed under the terms of the
3# GNU General Public License, version 2.
4#
5# $Id$
6
7package MT::XMLRPCServer::Util;
8use strict;
9use Time::Local qw( timegm );
10use MT::Util qw( offset_time_list );
11use MT::I18N qw( encode_text first_n_text const );
12
13sub mt_new {
14    my $cfg = $ENV{MOD_PERL} ?
15        Apache->request->dir_config('MTConfig') :
16        $MT::XMLRPCServer::MT_DIR . '/mt-config.cgi';
17    my $mt = MT->new( Config => $cfg )
18        or die MT::XMLRPCServer::_fault(MT->errstr);
19    # we need to be UTF-8 here no matter which PublishCharset
20    $main::server->serializer->encoding('UTF-8');
21    $mt->run_callbacks('init_app', $mt, {App => 'xmlrpc'});
22    $mt;
23}
24
25sub iso2ts {
26    my($blog, $iso) = @_;
27    die MT::XMLRPCServer::_fault(MT->translate("Invalid timestamp format"))
28        unless $iso =~ /^(\d{4})(?:-?(\d{2})(?:-?(\d\d?)(?:T(\d{2}):(\d{2}):(\d{2})(?:\.\d+)?(Z|[+-]\d{2}:\d{2})?)?)?)?/;
29    my($y, $mo, $d, $h, $m, $s, $offset) =
30    ($1, $2 || 1, $3 || 1, $4 || 0, $5 || 0, $6 || 0, $7);
31    if ($offset && !MT->config->IgnoreISOTimezones) {
32        $mo--;
33        $y -= 1900;
34        my $time = timegm($s, $m, $h, $d, $mo, $y);
35        ## If it's not already in UTC, first convert to UTC.
36        if ($offset ne 'Z') {
37            my($sign, $h, $m) = $offset =~ /([+-])(\d{2}):(\d{2})/;
38            $offset = $h * 3600 + $m * 60;
39            $offset *= -1 if $sign eq '-';
40            $time -= $offset;
41        }
42        ## Now apply the offset for this weblog.
43        ($s, $m, $h, $d, $mo, $y) = offset_time_list($time, $blog);
44        $mo++;
45        $y += 1900;
46    }
47    sprintf "%04d%02d%02d%02d%02d%02d", $y, $mo, $d, $h, $m, $s;
48}
49
50sub ts2iso {
51    my ($blog, $ts) = @_;
52    my ($yr, $mo, $dy, $hr, $mn, $sc) = unpack('A4A2A2A2A2A2A2', $ts);
53    $ts = timegm($sc, $mn, $hr, $dy, $mo, $yr);
54    ($sc, $mn, $hr, $dy, $mo, $yr) = offset_time_list($ts, $blog, '-');
55    $yr += 1900;
56    sprintf("%04d-%02d-%02d %02d:%02d:%02d", $yr, $mo, $dy, $hr, $mn, $sc);
57}
58
59package MT::XMLRPCServer;
60use strict;
61
62use MT;
63use MT::Util qw( first_n_words decode_html start_background_task archive_file_for );
64use MT::I18N qw( encode_text first_n_text const );
65use base qw( MT::ErrorHandler );
66
67our $MT_DIR;
68
69my($HAVE_XML_PARSER);
70BEGIN {
71    eval { require XML::Parser };
72    $HAVE_XML_PARSER = $@ ? 0 : 1;
73}
74
75sub _fault {
76    my $mt = MT::XMLRPCServer::Util::mt_new();
77    my $enc = $mt->config('PublishCharset');
78    SOAP::Fault->faultcode(1)->faultstring(
79        SOAP::Data->type(
80            string => encode_text($_[0], $enc, 'utf-8')));
81}
82
83## This is sort of a hack. XML::Parser automatically makes everything
84## UTF-8, and that is causing severe problems with the serialization
85## of database records (what happens is this: we construct a string
86## consisting of pack('N', length($string)) . $string. If the $string SV
87## is flagged as UTF-8, the packed length is then upgraded to UTF-8,
88## which turns characters with values greater than 128 into two bytes,
89## like v194.129. And so on. This is obviously now what we want, because
90## pack produces a series of bytes, not a string that should be mucked
91## about with.)
92##
93## The following subroutine strips the UTF8 flag from a string, thus
94## forcing it into a series of bytes. "pack 'C0'" is a magic way of
95## forcing the following string to be packed as bytes, not as UTF8.
96
97sub no_utf8 {
98    for (@_) {
99        next if ref;
100        $_ = pack 'C0A*', $_;
101    }
102}
103
104sub _make_token {
105    my @alpha = ('a'..'z', 'A'..'Z', 0..9);
106    my $token = join '', map $alpha[rand @alpha], 1..40;
107    $token;
108}
109
110sub _login {
111    my $class = shift;
112    my($user, $pass, $blog_id) = @_;
113    no_utf8($user, $pass);
114    my $mt = MT::XMLRPCServer::Util::mt_new();
115    my $enc = $mt->config('PublishCharset');
116    $user = encode_text($user, 'utf-8', $enc);
117    $pass = encode_text($pass, 'utf-8', $enc);
118    require MT::Author;
119    my $author = MT::Author->load({ name => $user, type => 1 }) or return;
120    die _fault(MT->translate("No web services password assigned.  Please see your user profile to set it.")) unless $author->api_password;
121    die _fault(MT->translate("Failed login attempt by disabled user '[_1]'")) unless $author->is_active;
122    my $auth = $author->api_password eq $pass;
123    $auth ||= crypt($pass, $author->api_password) eq $author->api_password;
124    return unless $auth;
125    return $author unless $blog_id;
126    require MT::Permission;
127    my $perms = MT::Permission->load({ author_id => $author->id,
128                                       blog_id => $blog_id });
129
130    ## update session so the user will be counted as active
131    require MT::Session;
132    my $sess_active = MT::Session->load( { kind => 'UA', name => $author->id } );
133    if (!$sess_active) {
134        $sess_active = MT::Session->new;
135        $sess_active->id(_make_token());
136        $sess_active->kind('UA'); # UA == User Activation
137        $sess_active->name($author->id);
138    }
139    $sess_active->start(time);
140    $sess_active->save;
141
142    ($author, $perms);
143}
144
145sub _publish {
146    my $class = shift;
147    my($mt, $entry, $no_ping) = @_;
148    require MT::Blog;
149    my $blog = MT::Blog->load($entry->blog_id);
150    $mt->rebuild_entry( Entry => $entry, Blog => $blog,
151                        BuildDependencies => 1 )
152        or return $class->error("Publish error: " . $mt->errstr);
153    unless ($no_ping) {
154        $mt->ping_and_save(Blog => $blog, Entry => $entry)
155            or return $class->error("Ping error: " . $mt->errstr);
156    }
157    1;
158}
159
160sub _apply_basename {
161    my $class = shift;
162    my ($entry, $item, $param) = @_;
163
164    my $basename = $item->{mt_basename} || $item->{wp_slug};
165    if ($param->{page} && $item->{permaLink}) {
166        local $entry->{column_values}->{basename} = '##s##';
167        my $real_url = $entry->archive_url();
168        my ($pre, $post) = split /##s##/, $real_url, 2;
169       
170        my $req_url = $item->{permaLink};
171        if ($req_url =~ m{ \A \Q$pre\E (.*) \Q$post\E \z }xms) {
172            my $req_base = $1;
173            my @folders = split /\//, $req_base;
174            $basename = pop @folders;
175            $param->{__permaLink_folders} = \@folders;
176        }
177        else {
178            die _fault(MT->translate("Requested permalink '[_1]' is not available for this page",
179                $req_url));
180        }
181    }
182
183    if (defined $basename) {
184        # Ensure this basename is unique.
185        my $entry_class = ref $entry;
186        my $basename_uses = $entry_class->count({
187            blog_id  => $entry->blog_id,
188            basename => $basename,
189            ($entry->id ? ( id => { op => '!=', value => $entry->id } ) : ()),
190        });
191        if ($basename_uses) {
192            $basename = MT::Util::make_unique_basename($entry);
193        }
194
195        $entry->basename($basename);
196    }
197
198    1;
199}
200
201sub _save_placements {
202    my $class = shift;
203    my ($entry, $item, $param) = @_;
204
205    my @categories;
206
207    if ($param->{page}) {
208        if (my $folders = $param->{__permaLink_folders}) {
209            my $parent_id = 0;
210            my $folder;
211            require MT::Folder;
212            for my $basename (@$folders) {
213                $folder = MT::Folder->load({
214                    blog_id  => $entry->blog_id,
215                    parent   => $parent_id,
216                    basename => $basename,
217                });
218
219                if (!$folder) {
220                    # Autovivify the folder tree.
221                    $folder = MT::Folder->new;
222                    $folder->blog_id($entry->blog_id);
223                    $folder->parent($parent_id);
224                    $folder->basename($basename);
225                    $folder->label($basename);
226                    $folder->save
227                      or die _fault(MT->translate("Saving folder failed: [_1]",
228                        $folder->errstr));
229                }
230
231                $parent_id = $folder->id;
232            }
233            @categories = ($folder) if $folder;
234        }
235    }
236    elsif (my $cats = $item->{categories}) {
237        my $cat_class = MT->model('category');
238        # The spec says to ignore invalid category names.
239        @categories = grep { defined } $cat_class->search({
240            blog_id => $entry->blog_id,
241            label   => $cats,
242        });
243    }
244
245    require MT::Placement;
246    my $is_primary_placement = 1;
247    CATEGORY: for my $category (@categories) {
248        my $place;
249        if ($is_primary_placement) {
250            $place = MT::Placement->load({
251                entry_id   => $entry->id,
252                is_primary => 1,
253            });
254        }
255        if (!$place) {
256            $place = MT::Placement->new;
257            $place->blog_id($entry->blog_id);
258            $place->entry_id($entry->id);
259            $place->is_primary($is_primary_placement ? 1 : 0);
260        }
261        $place->category_id($category->id);
262        $place->save
263          or die _fault(MT->translate("Saving placement failed: [_1]",
264            $place->errstr));
265
266        if ($is_primary_placement) {
267            # Delete all the secondary placements, so each of the remaining
268            # iterations of the loop make a brand new placement.
269            my @old_places = MT::Placement->load({
270                entry_id => $entry->id,
271                is_primary => 0,
272            });
273            for my $place (@old_places) {
274                $place->remove;
275            }
276        }
277
278        $is_primary_placement = 0;
279    }
280
281    1;
282}
283
284sub _new_entry {
285    my $class = shift;
286    my %param = @_;
287    my($blog_id, $user, $pass, $item, $publish) =
288        @param{qw( blog_id user pass item publish )};
289    my $obj_type = $param{page} ? 'page' : 'entry';
290    die _fault(MT->translate("No blog_id")) unless $blog_id;
291    my $mt = MT::XMLRPCServer::Util::mt_new();   ## Will die if MT->new fails.
292    no_utf8($blog_id, values %$item);
293    for my $f (qw( title description mt_text_more
294                   mt_excerpt mt_keywords mt_tags mt_basename wp_slug )) {
295        next unless defined $item->{$f}; 
296        my $enc = $mt->{cfg}->PublishCharset;
297        $item->{$f} = encode_text($item->{$f}, 'utf-8', $enc);
298        unless ($HAVE_XML_PARSER) {
299            $item->{$f} = decode_html($item->{$f});
300            $item->{$f} =~ s!'!'!g;  #'
301        }
302    }
303    require MT::Blog;
304    my $blog = MT::Blog->load($blog_id)
305        or die _fault(MT->translate("Invalid blog ID '[_1]'", $blog_id));
306    my($author, $perms) = $class->_login($user, $pass, $blog_id);
307    die _fault(MT->translate("Invalid login")) unless $author;
308    die _fault(MT->translate("Permission denied.")) unless $perms && $perms->can_create_post;
309    my $entry = MT->model($obj_type)->new;
310    my $orig_entry = $entry->clone;
311    $entry->blog_id($blog_id);
312    $entry->author_id($author->id);
313
314    ## In 2.1 we changed the behavior of the $publish flag. Previously,
315    ## it was used to determine the post status. That was a bad idea.
316    ## So now entries added through XML-RPC are always set to publish,
317    ## *unless* the user has set "NoPublishMeansDraft 1" in mt.cfg, which
318    ## enables the old behavior.
319    if ($mt->{cfg}->NoPublishMeansDraft) {
320        $entry->status($publish && $perms->can_publish_post ? MT::Entry::RELEASE() : MT::Entry::HOLD());
321    } else {
322        $entry->status($perms->can_publish_post ? MT::Entry::RELEASE() : MT::Entry::HOLD() );
323    }
324    $entry->allow_comments($blog->allow_comments_default);
325    $entry->allow_pings($blog->allow_pings_default);
326    $entry->convert_breaks(defined $item->{mt_convert_breaks} ? $item->{mt_convert_breaks} : $blog->convert_paras);
327    $entry->allow_comments($item->{mt_allow_comments})
328        if exists $item->{mt_allow_comments};
329    $entry->title($item->{title})
330        if exists $item->{title};
331
332    $class->_apply_basename($entry, $item, \%param);
333
334    $entry->text($item->{description});
335    for my $field (qw( allow_pings )) {
336        my $val = $item->{"mt_$field"};
337        next unless defined $val;
338        die _fault(MT->translate("Value for 'mt_[_1]' must be either 0 or 1 (was '[_2]')", $field, $val))
339            unless $val == 0 || $val == 1;
340        $entry->$field($val);
341    }
342    $entry->excerpt($item->{mt_excerpt}) if $item->{mt_excerpt};
343    $entry->text_more($item->{mt_text_more}) if $item->{mt_text_more};
344    $entry->keywords($item->{mt_keywords}) if $item->{mt_keywords};
345
346    if (my $tags = $item->{mt_tags}) {
347        require MT::Tag;
348        my $tag_delim = chr($author->entry_prefs->{tag_delim});
349        my @tags = MT::Tag->split($tag_delim, $tags);
350        $entry->set_tags(@tags);
351    }
352    if (my $urls = $item->{mt_tb_ping_urls}) {
353        no_utf8(@$urls);
354        $entry->to_ping_urls(join "\n", @$urls);
355    }
356    if (my $iso = $item->{dateCreated}) {
357        $entry->authored_on(MT::XMLRPCServer::Util::iso2ts($blog, $iso))
358            || die MT::XMLRPCServer::_fault(MT->translate("Invalid timestamp format"));
359        my @ts = MT::Util::offset_time_list(time, $blog_id);
360        my $ts = sprintf '%04d%02d%02d%02d%02d%02d',
361            $ts[5]+1900, $ts[4]+1, @ts[3,2,1,0];
362        $entry->status(MT::Entry::FUTURE())
363            if ($entry->authored_on > $ts);
364    }
365    $entry->discover_tb_from_entry();
366
367    MT->run_callbacks("api_pre_save.$obj_type", $mt, $entry, $orig_entry)
368        || die MT::XMLRPCServer::_fault(MT->translate("PreSave failed [_1]", MT->errstr));
369
370    $entry->save;
371
372    $class->_save_placements($entry, $item, \%param);
373
374    MT->run_callbacks("api_post_save.$obj_type", $mt, $entry, $orig_entry);
375
376    require MT::Log;
377    $mt->log({
378        message => $mt->translate("User '[_1]' (user #[_2]) added [lc,_4] #[_3]", $author->name, $author->id, $entry->id, $entry->class_label),
379        level => MT::Log::INFO(),
380        class => $obj_type,
381        category => 'new',
382        metadata => $entry->id
383    });
384
385    if ($publish) {
386        $class->_publish($mt, $entry) or die _fault($class->errstr);
387    }
388    delete $ENV{SERVER_SOFTWARE};
389    SOAP::Data->type(string => $entry->id);
390}
391
392sub newPost {
393    my $class = shift;
394    my($appkey, $blog_id, $user, $pass, $item, $publish);
395    if ($class eq 'blogger') {
396        ($appkey, $blog_id, $user, $pass, my($content), $publish) = @_;
397        $item->{description} = $content;
398    } else {
399        ($blog_id, $user, $pass, $item, $publish) = @_;
400    }
401    $class->_new_entry( blog_id => $blog_id, user => $user, pass => $pass,
402        item => $item, publish => $publish );
403}
404
405sub newPage {
406    my $class = shift;
407    my ($blog_id, $user, $pass, $item, $publish) = @_;
408    $class->_new_entry( blog_id => $blog_id, user => $user, pass => $pass,
409        item => $item, publish => $publish, page => 1 );
410}
411
412sub _edit_entry {
413    my $class = shift;
414    my %param = @_;
415    my ($blog_id, $entry_id, $user, $pass, $item, $publish) =
416        @param{qw( blog_id entry_id user pass item publish )};
417    my $obj_type = $param{page} ? 'page' : 'entry';
418    die _fault(MT->translate("No entry_id")) unless $entry_id;
419    my $mt = MT::XMLRPCServer::Util::mt_new();   ## Will die if MT->new fails.
420    no_utf8(values %$item);
421    for my $f (qw( title description mt_text_more
422                   mt_excerpt mt_keywords mt_tags mt_basename wp_slug )) {
423        next unless defined $item->{$f}; 
424        my $enc = $mt->config('PublishCharset');
425        $item->{$f} = encode_text($item->{$f}, 'utf-8', $enc);
426        unless ($HAVE_XML_PARSER) {
427            $item->{$f} = decode_html($item->{$f});
428            $item->{$f} =~ s!'!'!g;  #'
429        }
430    }
431    my $entry = MT->model($obj_type)->load($entry_id)
432        or die _fault(MT->translate("Invalid entry ID '[_1]'", $entry_id));
433    if ($blog_id && $blog_id != $entry->blog_id) {
434        die _fault(MT->translate("Invalid entry ID '[_1]'", $entry_id));
435    }
436    my($author, $perms) = $class->_login($user, $pass, $entry->blog_id);
437    die _fault(MT->translate("Invalid login")) unless $author;
438    die _fault(MT->translate("Not privileged to edit entry"))
439        unless $perms && $perms->can_edit_entry($entry, $author);
440    my $orig_entry = $entry->clone;
441    $entry->status(MT::Entry::RELEASE()) if $publish;
442    $entry->title($item->{title}) if $item->{title};
443
444    $class->_apply_basename($entry, $item, \%param);
445
446    $entry->text($item->{description});
447    $entry->convert_breaks($item->{mt_convert_breaks})
448        if exists $item->{mt_convert_breaks};
449    $entry->allow_comments($item->{mt_allow_comments})
450        if exists $item->{mt_allow_comments};
451    for my $field (qw( allow_pings )) {
452        my $val = $item->{"mt_$field"};
453        next unless defined $val;
454        die _fault(MT->translate("Value for 'mt_[_1]' must be either 0 or 1 (was '[_2]')", $field, $val))
455            unless $val == 0 || $val == 1;
456        $entry->$field($val);
457    }
458    $entry->excerpt($item->{mt_excerpt}) if defined $item->{mt_excerpt};
459    $entry->text_more($item->{mt_text_more}) if defined $item->{mt_text_more};
460    $entry->keywords($item->{mt_keywords}) if defined $item->{mt_keywords};
461    if (my $tags = $item->{mt_tags}) {
462        require MT::Tag;
463        my $tag_delim = chr($author->entry_prefs->{tag_delim});
464        my @tags = MT::Tag->split($tag_delim, $tags);
465        $entry->set_tags(@tags);
466    }
467    if (my $urls = $item->{mt_tb_ping_urls}) {
468        no_utf8(@$urls);
469        $entry->to_ping_urls(join "\n", @$urls);
470    }
471    if (my $iso = $item->{dateCreated}) {
472        $entry->authored_on(MT::XMLRPCServer::Util::iso2ts($entry->blog_id, $iso))
473           || die MT::XMLRPCServer::_fault(MT->translate("Invalid timestamp format"));
474    }
475    $entry->discover_tb_from_entry();
476
477    MT->run_callbacks("api_pre_save.$obj_type", $mt, $entry,
478        $orig_entry)
479        || die MT::XMLRPCServer::_fault(MT->translate("PreSave failed [_1]", MT->errstr));
480
481    $entry->save;
482
483    $class->_save_placements($entry, $item, \%param);
484
485    MT->run_callbacks("api_post_save.$obj_type", $mt, $entry,
486        $orig_entry);
487
488    require MT::Log;
489    $mt->log({
490        message => $mt->translate("User '[_1]' (user #[_2]) edited [lc,_4] #[_3]", $author->name, $author->id, $entry->id, $entry->class_label),
491        level => MT::Log::INFO(),
492        class => $obj_type,
493        category => 'new',
494        metadata => $entry->id
495    });
496
497    if ($publish) {
498        $class->_publish($mt, $entry) or die _fault($class->errstr);
499    }
500    SOAP::Data->type(boolean => 1);
501}
502
503sub editPost {
504    my $class = shift;
505    my($entry_id, $user, $pass, $item, $publish);
506    if ($class eq 'blogger') {
507        (my($appkey), $entry_id, $user, $pass, my($content), $publish) = @_;
508        $item->{description} = $content;
509    }
510    else {
511        ($entry_id, $user, $pass, $item, $publish) = @_;
512    }
513    $class->_edit_entry( entry_id => $entry_id, user => $user, pass => $pass,
514        item => $item, publish => $publish );
515}
516
517sub editPage {
518    my $class = shift;
519    my($blog_id, $entry_id, $user, $pass, $item, $publish) = @_;
520    $class->_edit_entry( blog_id => $blog_id, entry_id => $entry_id,
521        user => $user, pass => $pass, item => $item, publish => $publish,
522        page => 1 );
523}
524
525sub getUsersBlogs {
526    my $class;
527    if (UNIVERSAL::isa($_[0] => __PACKAGE__)) {
528        $class = shift;
529    } else {
530        $class = __PACKAGE__;
531    }
532    my($appkey, $user, $pass) = @_;
533    my $mt = MT::XMLRPCServer::Util::mt_new();   ## Will die if MT->new fails.
534    my($author) = $class->_login($user, $pass);
535    die _fault(MT->translate("Invalid login")) unless $author;
536    require MT::Permission;
537    require MT::Blog;
538    my $iter = MT::Permission->load_iter({ author_id => $author->id });
539    my @res;
540    while (my $perms = $iter->()) {
541        next unless $perms->can_create_post;
542        my $blog = MT::Blog->load($perms->blog_id);
543        next unless $blog;
544        push @res, { url => SOAP::Data->type(string => $blog->site_url),
545                     blogid => SOAP::Data->type(string => $blog->id),
546                     blogName => SOAP::Data->type(string => encode_text($blog->name, undef, 'utf-8')) };
547    }
548    \@res;
549}
550
551sub getUserInfo {
552    my $class;
553    if (UNIVERSAL::isa($_[0] => __PACKAGE__)) {
554        $class = shift;
555    } else {
556        $class = __PACKAGE__;
557    }
558    my($appkey, $user, $pass) = @_;
559    my $mt = MT::XMLRPCServer::Util::mt_new();   ## Will die if MT->new fails.
560    my($author) = $class->_login($user, $pass);
561    die _fault(MT->translate("Invalid login")) unless $author;
562    my($fname, $lname) = map { encode_text($_, undef, 'utf-8') } split /\s+/, $author->name;
563    $lname ||= '';
564    { userid => SOAP::Data->type(string => $author->id),
565      firstname => SOAP::Data->type(string => $fname),
566      lastname => SOAP::Data->type(string => $lname),
567      nickname => SOAP::Data->type(string => encode_text($author->nickname, undef, 'utf-8')),
568      email => SOAP::Data->type(string => $author->email),
569      url => SOAP::Data->type(string => $author->url) };
570}
571
572sub _get_entries {
573    my $class = shift;
574    my %param = @_;
575    my($blog_id, $user, $pass, $num, $titles_only) =
576        @param{qw( blog_id user pass num titles_only )};
577    my $obj_type = $param{page} ? 'page' : 'entry';
578    my $mt = MT::XMLRPCServer::Util::mt_new();   ## Will die if MT->new fails.
579    my($author, $perms) = $class->_login($user, $pass, $blog_id);
580    die _fault(MT->translate("Invalid login")) unless $author;
581    die _fault(MT->translate("Permission denied.")) unless $perms && $perms->can_create_post;
582    require MT::Blog;
583    my $blog = MT::Blog->load($blog_id);
584    my $iter = MT->model($obj_type)->load_iter({ blog_id => $blog_id },
585        { 'sort' => 'authored_on',
586          direction => 'descend',
587          limit => $num });
588    my @res;
589    while (my $entry = $iter->()) {
590        my $co = sprintf "%04d%02d%02dT%02d:%02d:%02d",
591            unpack 'A4A2A2A2A2A2', $entry->authored_on;
592        my $row = { dateCreated => SOAP::Data->type(dateTime => $co),
593                    userid => SOAP::Data->type(string => $entry->author_id) };
594        $row->{ $param{page} ? 'page_id' : 'postid' } =
595            SOAP::Data->type(string => $entry->id);
596        if ($class eq 'blogger') {
597            $row->{content} = SOAP::Data->type(string => encode_text($entry->text, undef, 'utf-8'));
598        } else {
599            $row->{title} = SOAP::Data->type(string => encode_text($entry->title, undef, 'utf-8'));
600            unless ($titles_only) {
601                require MT::Tag;
602                my $tag_delim = chr($author->entry_prefs->{tag_delim});
603                my $tags = MT::Tag->join($tag_delim, $entry->tags);
604                $row->{description} = SOAP::Data->type(string => encode_text($entry->text, undef, 'utf-8'));
605                my $link = $entry->permalink;
606                $row->{link} = SOAP::Data->type(string => $link);
607                $row->{permaLink} = SOAP::Data->type(string => $link),
608                $row->{mt_basename} = SOAP::Data->type(string => encode_text($entry->basename, undef, 'utf-8'));
609                $row->{mt_allow_comments} = SOAP::Data->type(int => $entry->allow_comments);
610                $row->{mt_allow_pings} = SOAP::Data->type(int => $entry->allow_pings);
611                $row->{mt_convert_breaks} = SOAP::Data->type(string => $entry->convert_breaks);
612                $row->{mt_text_more} = SOAP::Data->type(string => encode_text($entry->text_more, undef, 'utf-8'));
613                $row->{mt_excerpt} = SOAP::Data->type(string => encode_text($entry->excerpt, undef, 'utf-8'));
614                $row->{mt_keywords} = SOAP::Data->type(string => encode_text($entry->keywords, undef, 'utf-8'));
615                $row->{mt_tags} = SOAP::Data->type(string => encode_text($tags, undef, 'utf-8'));
616            }
617        }
618        push @res, $row;
619    }
620    \@res;
621}
622
623sub getRecentPosts {
624    my $class = shift;
625    my ($blog_id, $user, $pass, $num);
626    if ($class eq 'blogger') {
627        (my($appkey), $blog_id, $user, $pass, $num) = @_;
628    }
629    else {
630        ($blog_id, $user, $pass, $num) = @_;
631    }
632    $class->_get_entries( blog_id => $blog_id, user => $user,
633        pass => $pass, num => $num );
634}
635
636sub getRecentPostTitles {
637    my $class = shift;
638    my ($blog_id, $user, $pass, $num) = @_;
639    $class->_get_entries( blog_id => $blog_id, user => $user,
640        pass => $pass, num => $num, titles_only => 1 );
641}
642
643sub getPages {
644    my $class = shift;
645    my ($blog_id, $user, $pass) = @_;
646    $class->_get_entries( blog_id => $blog_id, user => $user,
647        pass => $pass, page => 1 );
648}
649
650sub _delete_entry {
651    my $class = shift;
652    my %param = @_;
653    my ($blog_id, $entry_id, $user, $pass, $publish) =
654        @param{qw( blog_id entry_id user pass publish )};
655    my $mt = MT::XMLRPCServer::Util::mt_new();   ## Will die if MT->new fails.
656    my $obj_type = $param{page} ? 'page' : 'entry';
657    my $entry = MT->model($obj_type)->load($entry_id)
658        or die _fault(MT->translate("Invalid entry ID '[_1]'", $entry_id));
659    my($author, $perms) = $class->_login($user, $pass, $entry->blog_id);
660    die _fault(MT->translate("Invalid login")) unless $author;
661    die _fault(MT->translate("Permission denied."))
662        unless $perms && $perms->can_edit_entry($entry, $author);
663    $entry->remove;
664
665    $mt->log({
666        message => $mt->translate("Entry '[_1]' ([lc,_5] #[_2]) deleted by '[_3]' (user #[_4]) from xml-rpc", $entry->title, $entry->id, $author->name, $author->id, $entry->class_label),
667        level => MT::Log::INFO(),
668        class => 'system',
669        category => 'delete' 
670    });
671
672    if ($publish) {
673        $class->_publish($mt, $entry, 1) or die _fault($class->errstr);
674    }
675    SOAP::Data->type(boolean => 1);
676}
677
678sub deletePost {
679    my $class;
680    if (UNIVERSAL::isa($_[0] => __PACKAGE__)) {
681        $class = shift;
682    } else {
683        $class = __PACKAGE__;
684    }
685    my($appkey, $entry_id, $user, $pass, $publish) = @_;
686    $class->_delete_entry( entry_id => $entry_id, user => $user,
687        pass => $pass, publish => $publish );
688}
689
690sub deletePage {
691    my $class = shift;
692    my ($blog_id, $user, $pass, $entry_id) = @_;
693    $class->_delete_entry( blog_id => $blog_id, entry_id => $entry_id,
694        user => $user, pass => $pass, publish => 1, page => 1 );
695}
696
697sub _get_entry {
698    my $class = shift;
699    my %param = @_;
700    my($blog_id, $entry_id, $user, $pass) =
701        @param{qw( blog_id entry_id user pass )};
702    my $obj_type = $param{page} ? 'page' : 'entry';
703    my $mt = MT::XMLRPCServer::Util::mt_new();   ## Will die if MT->new fails.
704    my $entry = MT->model($obj_type)->load($entry_id)
705        or die _fault(MT->translate("Invalid entry ID '[_1]'", $entry_id));
706    if ($blog_id && $blog_id != $entry->blog_id) {
707        die _fault(MT->translate("Invalid entry ID '[_1]'", $entry_id));
708    }
709    my($author, $perms) = $class->_login($user, $pass, $entry->blog_id);
710    die _fault(MT->translate("Invalid login")) unless $author;
711    die _fault(MT->translate("Not privileged to get entry"))
712        unless $perms && $perms->can_edit_entry($entry, $author);
713    my $co = sprintf "%04d%02d%02dT%02d:%02d:%02d",
714        unpack 'A4A2A2A2A2A2', $entry->authored_on;
715    require MT::Blog;
716    my $blog = MT::Blog->load($entry->blog_id);
717    my $link = $entry->permalink;
718    require MT::Tag;
719    my $delim = chr($author->entry_prefs->{tag_delim});
720    my $tags = MT::Tag->join($delim, $entry->tags);
721
722    my $cats = [];
723    my $cat_data = $entry->__load_category_data();
724    if (scalar @$cat_data) {
725        my ($first_cat) = grep {  $_->[1] } @$cat_data;
726        my @cat_ids     = grep { !$_->[1] } @$cat_data;
727        unshift @cat_ids, $first_cat if $first_cat;
728        $cats = MT->model('category')->lookup_multi(
729            [ map { $_->[0] } @cat_ids ]);
730    }
731
732    my $basename = SOAP::Data->type(string => encode_text($entry->basename, undef, 'utf-8'));
733    {
734        dateCreated => SOAP::Data->type(dateTime => $co),
735        userid => SOAP::Data->type(string => $entry->author_id),
736        ($param{page} ? 'page_id' : 'postid') => SOAP::Data->type(string => $entry->id),
737        description => SOAP::Data->type(string => encode_text($entry->text, undef, 'utf-8')),
738        title => SOAP::Data->type(string => encode_text($entry->title, undef, 'utf-8')),
739        mt_basename => $basename,
740        wp_slug => $basename,
741        link => SOAP::Data->type(string => $link),
742        permaLink => SOAP::Data->type(string => $link),
743        categories => [ map { SOAP::Data->type(string => $_->label) } @$cats ],
744        mt_allow_comments => SOAP::Data->type(int => $entry->allow_comments),
745        mt_allow_pings => SOAP::Data->type(int => $entry->allow_pings),
746        mt_convert_breaks => SOAP::Data->type(string => $entry->convert_breaks),
747        mt_text_more => SOAP::Data->type(string => encode_text($entry->text_more, undef, 'utf-8')),
748        mt_excerpt => SOAP::Data->type(string => encode_text($entry->excerpt, undef, 'utf-8')),
749        mt_keywords => SOAP::Data->type(string => encode_text($entry->keywords, undef, 'utf-8')),
750        mt_tags => SOAP::Data->type(string => encode_text($tags, undef, 'utf-8')),
751    }
752}
753
754sub getPost {
755    my $class = shift;
756    my($entry_id, $user, $pass) = @_;
757    $class->_get_entry( entry_id => $entry_id, user => $user, pass => $pass );
758}
759
760sub getPage {
761    my $class = shift;
762    my ($blog_id, $entry_id, $user, $pass) = @_;
763    $class->_get_entry( blog_id => $blog_id, entry_id => $entry_id,
764        user => $user, pass => $pass, page => 1 );
765}
766
767sub supportedMethods {
768    [ 'blogger.newPost', 'blogger.editPost', 'blogger.getRecentPosts',
769      'blogger.getUsersBlogs', 'blogger.getUserInfo', 'blogger.deletePost',
770      'metaWeblog.getPost', 'metaWeblog.newPost', 'metaWeblog.editPost',
771      'metaWeblog.getRecentPosts', 'metaWeblog.newMediaObject',
772      'metaWeblog.getCategories', 'metaWeblog.deletePost',
773      'metaWeblog.getUsersBlogs',
774      'wp.newPage', 'wp.getPages', 'wp.getPage', 'wp.editPage',
775      'wp.deletePage',
776       # not yet supported: metaWeblog.getTemplate, metaWeblog.setTemplate
777      'mt.getCategoryList', 'mt.setPostCategories', 'mt.getPostCategories',
778      'mt.getTrackbackPings', 'mt.supportedTextFilters',
779      'mt.getRecentPostTitles', 'mt.publishPost', 'mt.getTagList' ];
780}
781
782sub supportedTextFilters {
783    my $mt = MT::XMLRPCServer::Util::mt_new();   ## Will die if MT->new fails.
784    my $filters = $mt->all_text_filters;
785    my @res;
786    for my $filter (keys %$filters) {
787        my $label = $filters->{$filter}{label};
788        if ('CODE' eq ref($label)) {
789            $label = $label->();
790        }
791        push @res, {
792            key => SOAP::Data->type(string => $filter),
793            label => SOAP::Data->type(string => $label)
794        };
795    }
796    \@res;
797}
798
799## getCategoryList, getPostCategories, and setPostCategories were
800## originally written by Daniel Drucker with the assistance of
801## Six Apart, then later modified by Six Apart.
802
803sub getCategoryList {
804    my $class = shift;
805    my($blog_id, $user, $pass) = @_;
806    my $mt = MT::XMLRPCServer::Util::mt_new();   ## Will die if MT->new fails.
807    my($author, $perms) = $class->_login($user, $pass, $blog_id);
808    die _fault(MT->translate("Invalid login")) unless $author;
809    die _fault(MT->translate("Permission denied."))
810        unless $perms && $perms->can_create_post;
811    require MT::Category;
812    my $iter = MT::Category->load_iter({ blog_id => $blog_id });
813    my @data;
814    while (my $cat = $iter->()) {
815        push @data, {
816            categoryName => SOAP::Data->type(string => encode_text($cat->label, undef, 'utf-8')),
817            categoryId => SOAP::Data->type(string => $cat->id)
818        };
819    }
820    \@data;
821}
822
823sub getCategories {
824    my $class = shift;
825    my($blog_id, $user, $pass) = @_;
826    my $mt = MT::XMLRPCServer::Util::mt_new();   ## Will die if MT->new fails.
827    my($author, $perms) = $class->_login($user, $pass, $blog_id);
828    die _fault(MT->translate("Invalid login")) unless $author;
829    die _fault(MT->translate("Permission denied."))
830        unless $perms && $perms->can_create_post;
831    require MT::Category;
832    my $iter = MT::Category->load_iter({ blog_id => $blog_id });
833    my @data;
834    my $blog = MT::Blog->load($blog_id);
835    require File::Spec;
836    while (my $cat = $iter->()) {
837        my $url = File::Spec->catfile($blog->site_url, archive_file_for( undef, $blog, 'Category', $cat ));
838        push @data, {
839            categoryId => SOAP::Data->type(string => encode_text($cat->id, undef, 'utf-8')),
840            parentId => ($cat->parent_category ? SOAP::Data->type(string => encode_text($cat->parent_category->id, undef, 'utf-8')) : undef),
841            categoryName => SOAP::Data->type(string => encode_text($cat->label, undef, 'utf-8')),
842            title => SOAP::Data->type(string => encode_text($cat->label, undef, 'utf-8')),
843            description => SOAP::Data->type(string => encode_text($cat->description, undef, 'utf-8')),
844            htmlUrl => SOAP::Data->type(string => encode_text($url, undef, 'utf-8')),
845        };
846    }
847    \@data;
848}
849
850sub getTagList {
851    my $class = shift;
852    my($blog_id, $user, $pass) = @_;
853    my $mt = MT::XMLRPCServer::Util::mt_new();   ## Will die if MT->new fails.
854    my($author, $perms) = $class->_login($user, $pass, $blog_id);
855    die _fault(MT->translate("Invalid login")) unless $author;
856    die _fault(MT->translate("Permission denied."))
857        unless $perms && $perms->can_create_post;
858    require MT::Tag;
859    require MT::ObjectTag;
860    my $iter = MT::Tag->load_iter(undef, { join => ['MT::ObjectTag', 'tag_id', { blog_id => $blog_id }, { unique => 1 } ] } );
861    my @data;
862    while (my $tag = $iter->()) {
863        push @data, {
864            tagName => SOAP::Data->type(string => encode_text($tag->name, undef, 'utf-8')),
865            tagId => SOAP::Data->type(string => $tag->id)
866        };
867    }
868    \@data;
869}
870
871sub getPostCategories {
872    my $class = shift;
873    my($entry_id, $user, $pass) = @_;
874    my $mt = MT::XMLRPCServer::Util::mt_new();   ## Will die if MT->new fails.
875    require MT::Entry;
876    my $entry = MT::Entry->load($entry_id)
877        or die _fault(MT->translate("Invalid entry ID '[_1]'", $entry_id));
878    my($author, $perms) = $class->_login($user, $pass, $entry->blog_id);
879    die _fault(MT->translate("Invalid login")) unless $author;
880    die _fault(MT->translate("Permission denied.")) unless $perms && $perms->can_create_post;
881    my @data;
882    my $prim = $entry->category;
883    my $cats = $entry->categories;
884    for my $cat (@$cats) {
885        my $is_primary = $prim && $cat->id == $prim->id ? 1 : 0;
886        push @data, {
887            categoryName => SOAP::Data->type(string => encode_text($cat->label, undef, 'utf-8')),
888            categoryId => SOAP::Data->type(string => $cat->id),
889            isPrimary => SOAP::Data->type(boolean => $is_primary),
890        };
891    }
892    \@data;
893}
894
895sub setPostCategories {
896    my $class = shift;
897    my($entry_id, $user, $pass, $cats) = @_;
898    my $mt = MT::XMLRPCServer::Util::mt_new();   ## Will die if MT->new fails.
899    require MT::Entry;
900    require MT::Placement;
901    my $entry = MT::Entry->load($entry_id)
902         or die _fault(MT->translate("Invalid entry ID '[_1]'", $entry_id));
903    my($author, $perms) = $class->_login($user, $pass, $entry->blog_id);
904    die _fault(MT->translate("Invalid login")) unless $author;
905    die _fault(MT->translate("Not privileged to set entry categories"))
906        unless $perms && $perms->can_edit_entry($entry, $author);
907    my @place = MT::Placement->load({ entry_id => $entry_id });
908    for my $place (@place) {
909         $place->remove;
910    }
911    ## Keep track of which category is named the primary category.
912    ## If the first structure in the array does not have an isPrimary
913    ## key, we just make it the primary category; if it does, we use
914    ## that flag to determine the primary category.
915    my $is_primary = 1;
916    for my $cat (@$cats) {
917         my $place = MT::Placement->new;
918         $place->entry_id($entry_id);
919         $place->blog_id($entry->blog_id);
920         if (defined $cat->{isPrimary} && $is_primary) {
921             $place->is_primary($cat->{isPrimary});
922         } else {
923             $place->is_primary($is_primary);
924         }
925         ## If we just set the is_primary flag to 1, we don't want to
926         ## make any other categories primary.
927         $is_primary = 0 if $place->is_primary;
928         $place->category_id($cat->{categoryId});
929         $place->save
930              or die _fault(MT->translate("Saving placement failed: [_1]", $place->errstr));
931    }
932    SOAP::Data->type(boolean => 1);
933}
934
935sub getTrackbackPings {
936    my $class = shift;
937    my($entry_id) = @_;
938    require MT::Trackback;
939    require MT::TBPing;
940    my $mt = MT::XMLRPCServer::Util::mt_new();   ## Will die if MT->new fails.
941    my $tb = MT::Trackback->load({ entry_id => $entry_id })
942        or return [];
943    my $iter = MT::TBPing->load_iter({ tb_id => $tb->id });
944    my @data;
945    while (my $ping = $iter->()) {
946        push @data, {
947            pingTitle => SOAP::Data->type(string => encode_text($ping->title, undef, 'utf-8')),
948            pingURL => SOAP::Data->type(string => $ping->source_url),
949            pingIP => SOAP::Data->type(string => $ping->ip),
950        };
951    }
952    \@data;
953}
954
955sub publishPost {
956    my $class = shift;
957    my($entry_id, $user, $pass) = @_;
958    my $mt = MT::XMLRPCServer::Util::mt_new();   ## Will die if MT->new fails.
959    require MT::Entry;
960    my $entry = MT::Entry->load($entry_id)
961        or die _fault(MT->translate("Invalid entry ID '[_1]'", $entry_id));
962    my($author, $perms) = $class->_login($user, $pass, $entry->blog_id);
963    die _fault(MT->translate("Invalid login")) unless $author;
964    die _fault(MT->translate("Not privileged to edit entry"))
965        unless $perms && $perms->can_edit_entry($entry, $author);
966    $mt->rebuild_entry( Entry => $entry, BuildDependencies => 1 )
967        or die _fault(MT->translate("Publish failed: [_1]", $mt->errstr));
968    SOAP::Data->type(boolean => 1);
969}
970
971sub runPeriodicTasks {
972    my $class = shift;
973    my ($user, $pass) = @_;
974
975    my $mt = MT::XMLRPCServer::Util::mt_new();
976    my $author = $class->_login($user, $pass);
977    die _fault(MT->translate("Invalid login")) unless $author;
978
979    $mt->run_tasks;
980
981    { responseCode => 'success' }
982}
983
984sub publishScheduledFuturePosts {
985    my $class = shift;
986    my ($blog_id, $user, $pass) = @_;
987
988    my $mt = MT::XMLRPCServer::Util::mt_new();
989    my $author = $class->_login($user, $pass);
990    die _fault(MT->translate("Invalid login")) unless $author;
991    my $blog = MT::Blog->load($blog_id);
992
993    my $now = time;
994    # Convert $now to user's timezone, which is how future post dates
995    # are stored.
996    $now = MT::Util::offset_time($now);
997    $now = strftime("%Y%m%d%H%M%S", gmtime($now));
998
999    my $iter = MT::Entry->load_iter({
1000        blog_id => $blog->id,
1001        status => MT::Entry::FUTURE()},
1002        {'sort' => 'authored_on',
1003         direction => 'descend'
1004    });
1005    my @queue;
1006    while (my $i = $iter->()) {
1007        push @queue, $i->id();
1008    }
1009
1010    my $changed = 0;
1011    my $total_changed = 0;
1012    my @results;
1013    foreach my $entry_id (@queue) {
1014        my $entry = MT::Entry->load($entry_id);
1015        if ($entry->authored_on <= $now) {
1016            $entry->status(MT::Entry::RELEASE());
1017            $entry->discover_tb_from_entry();
1018            $entry->save
1019                or die $entry->errstr;
1020
1021            start_background_task(sub {
1022                $mt->rebuild_entry( Entry => $entry, Blog => $blog )
1023                    or die $mt->errstr;
1024            });
1025            $changed++;
1026            $total_changed++;
1027        }
1028    }
1029    if ($changed) {
1030        $mt->rebuild_indexes( Blog => $blog )
1031            or die $mt->errstr;
1032    }
1033    { responseCode => 'success', 
1034      publishedCount => $total_changed,
1035    };
1036}
1037
1038sub getNextScheduled {
1039    my $class = shift;
1040    my ($user, $pass) = @_;
1041
1042    my $mt = MT::XMLRPCServer::Util::mt_new();
1043    my $author = $class->_login($user, $pass);
1044    die _fault(MT->translate("Invalid login")) unless $author;
1045
1046    my $next_scheduled = MT::get_next_sched_post_for_user($author->id());
1047
1048    { nextScheduledTime => $next_scheduled };
1049}
1050
1051sub setRemoteAuthToken {
1052    my $class = shift;
1053    my ($user, $pass, $remote_auth_username, $remote_auth_token) = @_;
1054    my $mt = MT::XMLRPCServer::Util::mt_new();   ## Will die if MT->new fails.
1055    my($author) = $class->_login($user, $pass);
1056    die _fault(MT->translate("Invalid login")) unless $author;
1057    $author->remote_auth_username($remote_auth_username);
1058    $author->remote_auth_token($remote_auth_token);
1059    $author->save();
1060    1;
1061}
1062
1063sub newMediaObject {
1064    my $class = shift;
1065    my($blog_id, $user, $pass, $file) = @_;
1066    my $mt = MT::XMLRPCServer::Util::mt_new();   ## Will die if MT->new fails.
1067    my($author, $perms) = $class->_login($user, $pass, $blog_id);
1068    die _fault(MT->translate("Invalid login")) unless $author;
1069    die _fault(MT->translate("Not privileged to upload files"))
1070        unless $perms && $perms->can_upload;
1071    require MT::Blog;
1072    require File::Spec;
1073    my $blog = MT::Blog->load($blog_id);
1074    my $fname = $file->{name} or die _fault(MT->translate("No filename provided"));
1075    if ($fname =~ m!\.\.|\0|\|!) {
1076        die _fault(MT->translate("Invalid filename '[_1]'", $fname));
1077    }
1078    my $local_file = File::Spec->catfile($blog->site_path, $file->{name});
1079    my $fmgr = $blog->file_mgr;
1080    my($vol, $path, $name) = File::Spec->splitpath($local_file);
1081    $path =~ s!/$!! unless $path eq '/';  ## OS X doesn't like / at the end in mkdir().
1082    unless ($fmgr->exists($path)) {
1083        $fmgr->mkpath($path)
1084            or die _fault(MT->translate("Error making path '[_1]': [_2]", $path, $fmgr->errstr));
1085    }
1086    defined(my $bytes = $fmgr->put_data($file->{bits}, $local_file, 'upload'))
1087        or die _fault(MT->translate("Error writing uploaded file: [_1]", $fmgr->errstr));
1088    my $url = $blog->site_url . $fname;
1089
1090    require File::Basename;
1091    my $local_basename = File::Basename::basename($local_file);
1092    my $ext =
1093        ( File::Basename::fileparse( $local_file, qr/[A-Za-z0-9]+$/ ) )[2];
1094    eval { require Image::Size; };
1095    die _fault(MT->translate("Perl module Image::Size is required to determine width and height of uploaded images.")) if $@;
1096    my ( $w, $h, $id ) = Image::Size::imgsize($local_file);
1097
1098    require MT::Asset;
1099    my $asset_pkg = MT::Asset->handler_for_file($local_basename);
1100    my $is_image  = defined($w)
1101      && defined($h)
1102      && $asset_pkg->isa('MT::Asset::Image');
1103    my $asset;
1104    if (!($asset = $asset_pkg->load(
1105                { file_path => $local_file, blog_id => $blog_id })))
1106    {
1107        $asset = $asset_pkg->new();
1108        $asset->file_path($local_file);
1109        $asset->file_name($local_basename);
1110        $asset->file_ext($ext);
1111        $asset->blog_id($blog_id);
1112        $asset->created_by( $author->id );
1113    }
1114    else {
1115        $asset->modified_by( $author->id );
1116    }
1117    my $original = $asset->clone;
1118    $asset->url($url);
1119    if ($is_image) {
1120        $asset->image_width($w);
1121        $asset->image_height($h);
1122    }
1123    $asset->mime_type($file->{type});
1124    $asset->save;
1125
1126    MT->run_callbacks(
1127        'api_upload_file.' . $asset->class,
1128        File => $local_file, file => $local_file,
1129        Url => $url, url => $url,
1130        Size => $bytes, size => $bytes,
1131        Asset => $asset, asset => $asset,
1132        Type => $asset->class, type => $asset->class,
1133        Blog => $blog,blog => $blog);
1134    if ($is_image) {
1135        MT->run_callbacks(
1136            'api_upload_image',
1137            File => $local_file, file => $local_file,
1138            Url => $url, url => $url,
1139            Size => $bytes, size => $bytes,
1140            Asset => $asset, asset => $asset,
1141            Height => $h, height => $h,
1142            Width => $w, width => $w,
1143            Type => 'image', type => 'image',
1144            ImageType => $id, image_type => $id,
1145            Blog => $blog, blog => $blog);
1146    }
1147
1148    { url => SOAP::Data->type(string => $url) };
1149}
1150
1151## getTemplate and setTemplate are not applicable in MT's template
1152## structure, so they are unimplemented (they return a fault).
1153## We assign it twice to get rid of "setTemplate used only once" warnings.
1154
1155sub getTemplate {
1156    die _fault(MT->translate(
1157        "Template methods are not implemented, due to differences between the Blogger API and the Movable Type API."));
1158}
1159*setTemplate = *setTemplate = \&getTemplate;
1160
1161## The above methods will be called as blogger.newPost, blogger.editPost,
1162## etc., because we are implementing Blogger's API. Thus, the empty
1163## subclass.
1164package blogger;
1165BEGIN { @blogger::ISA = qw( MT::XMLRPCServer ); }
1166
1167package metaWeblog;
1168BEGIN { @metaWeblog::ISA = qw( MT::XMLRPCServer ); }
1169
1170package mt;
1171BEGIN { @mt::ISA = qw( MT::XMLRPCServer ); }
1172
1173package wp;
1174BEGIN { @wp::ISA = qw( MT::XMLRPCServer ); }
1175
11761;
1177__END__
1178
1179=head1 NAME
1180
1181MT::XMLRPCServer
1182
1183=head1 SYNOPSIS
1184
1185An XMLRPC API interface for communicating with Movable Type.
1186
1187=head1 CALLBACKS
1188
1189=over 4
1190
1191=item api_pre_save.entry
1192=item api_pre_save.page
1193
1194    callback($eh, $mt, $entry, $original_entry)
1195
1196Called before saving a new or existing entry. If saving a new entry, the
1197$original_entry will have an unassigned 'id'. This callback is executed
1198as a filter, so your handler must return 1 to allow the entry to be saved.
1199
1200=item api_post_save.entry
1201=item api_post_save.page
1202
1203    callback($eh, $mt, $entry, $original_entry)
1204
1205Called after saving a new or existing entry. If saving a new entry, the
1206$original_entry will have an unassigned 'id'.
1207
1208=item api_upload_file
1209
1210    callback($eh, %params)
1211
1212This callback is invoked for each file the user uploads to the weblog.
1213This callback is similar to the CMSUploadFile callback found in
1214C<MT::App::CMS>.
1215
1216=back
1217
1218=head2 Parameters
1219
1220=over 4
1221
1222=item File
1223
1224The full physical file path of the uploaded file.
1225
1226=item Url
1227
1228The full URL to the file that has been uploaded.
1229
1230=item Type
1231
1232For this callback, this value is currently always 'file'.
1233
1234=item Blog
1235
1236The C<MT::Blog> object associated with the newly uploaded file.
1237
1238=back
1239
1240=cut
Note: See TracBrowser for help on using the browser.