]> scripts.mit.edu Git - autoinstalls/wordpress.git/blob - wp-admin/includes/update-core.php
Wordpress 3.2.1
[autoinstalls/wordpress.git] / wp-admin / includes / update-core.php
1 <?php
2 /**
3  * WordPress core upgrade functionality.
4  *
5  * @package WordPress
6  * @subpackage Administration
7  * @since 2.7.0
8  */
9
10 /**
11  * Stores files to be deleted.
12  *
13  * @since 2.7.0
14  * @global array $_old_files
15  * @var array
16  * @name $_old_files
17  */
18 global $_old_files;
19
20 $_old_files = array(
21 'wp-admin/bookmarklet.php',
22 'wp-admin/css/upload.css',
23 'wp-admin/css/upload-rtl.css',
24 'wp-admin/css/press-this-ie.css',
25 'wp-admin/css/press-this-ie-rtl.css',
26 'wp-admin/edit-form.php',
27 'wp-admin/link-import.php',
28 'wp-admin/images/box-bg-left.gif',
29 'wp-admin/images/box-bg-right.gif',
30 'wp-admin/images/box-bg.gif',
31 'wp-admin/images/box-butt-left.gif',
32 'wp-admin/images/box-butt-right.gif',
33 'wp-admin/images/box-butt.gif',
34 'wp-admin/images/box-head-left.gif',
35 'wp-admin/images/box-head-right.gif',
36 'wp-admin/images/box-head.gif',
37 'wp-admin/images/heading-bg.gif',
38 'wp-admin/images/login-bkg-bottom.gif',
39 'wp-admin/images/login-bkg-tile.gif',
40 'wp-admin/images/notice.gif',
41 'wp-admin/images/toggle.gif',
42 'wp-admin/images/comment-stalk-classic.gif',
43 'wp-admin/images/comment-stalk-fresh.gif',
44 'wp-admin/images/comment-stalk-rtl.gif',
45 'wp-admin/images/comment-pill.gif',
46 'wp-admin/images/del.png',
47 'wp-admin/images/media-button-gallery.gif',
48 'wp-admin/images/media-buttons.gif',
49 'wp-admin/images/tail.gif',
50 'wp-admin/images/gear.png',
51 'wp-admin/images/tab.png',
52 'wp-admin/images/postbox-bg.gif',
53 'wp-admin/includes/upload.php',
54 'wp-admin/js/dbx-admin-key.js',
55 'wp-admin/js/link-cat.js',
56 'wp-admin/js/forms.js',
57 'wp-admin/js/upload.js',
58 'wp-admin/js/set-post-thumbnail-handler.js',
59 'wp-admin/js/set-post-thumbnail-handler.dev.js',
60 'wp-admin/js/page.js',
61 'wp-admin/js/page.dev.js',
62 'wp-admin/js/slug.js',
63 'wp-admin/js/slug.dev.js',
64 'wp-admin/profile-update.php',
65 'wp-admin/templates.php',
66 'wp-includes/images/audio.png',
67 'wp-includes/images/css.png',
68 'wp-includes/images/default.png',
69 'wp-includes/images/doc.png',
70 'wp-includes/images/exe.png',
71 'wp-includes/images/html.png',
72 'wp-includes/images/js.png',
73 'wp-includes/images/pdf.png',
74 'wp-includes/images/swf.png',
75 'wp-includes/images/tar.png',
76 'wp-includes/images/text.png',
77 'wp-includes/images/video.png',
78 'wp-includes/images/zip.png',
79 'wp-includes/js/dbx.js',
80 'wp-includes/js/fat.js',
81 'wp-includes/js/list-manipulation.js',
82 'wp-includes/js/jquery/jquery.dimensions.min.js',
83 'wp-includes/js/tinymce/langs/en.js',
84 'wp-includes/js/tinymce/plugins/autosave/editor_plugin_src.js',
85 'wp-includes/js/tinymce/plugins/autosave/langs',
86 'wp-includes/js/tinymce/plugins/directionality/images',
87 'wp-includes/js/tinymce/plugins/directionality/langs',
88 'wp-includes/js/tinymce/plugins/inlinepopups/css',
89 'wp-includes/js/tinymce/plugins/inlinepopups/images',
90 'wp-includes/js/tinymce/plugins/inlinepopups/jscripts',
91 'wp-includes/js/tinymce/plugins/paste/images',
92 'wp-includes/js/tinymce/plugins/paste/jscripts',
93 'wp-includes/js/tinymce/plugins/paste/langs',
94 'wp-includes/js/tinymce/plugins/spellchecker/classes/HttpClient.class.php',
95 'wp-includes/js/tinymce/plugins/spellchecker/classes/TinyGoogleSpell.class.php',
96 'wp-includes/js/tinymce/plugins/spellchecker/classes/TinyPspell.class.php',
97 'wp-includes/js/tinymce/plugins/spellchecker/classes/TinyPspellShell.class.php',
98 'wp-includes/js/tinymce/plugins/spellchecker/css/spellchecker.css',
99 'wp-includes/js/tinymce/plugins/spellchecker/images',
100 'wp-includes/js/tinymce/plugins/spellchecker/langs',
101 'wp-includes/js/tinymce/plugins/spellchecker/tinyspell.php',
102 'wp-includes/js/tinymce/plugins/wordpress/images',
103 'wp-includes/js/tinymce/plugins/wordpress/langs',
104 'wp-includes/js/tinymce/plugins/wordpress/popups.css',
105 'wp-includes/js/tinymce/plugins/wordpress/wordpress.css',
106 'wp-includes/js/tinymce/plugins/wphelp',
107 'wp-includes/js/tinymce/themes/advanced/css',
108 'wp-includes/js/tinymce/themes/advanced/images',
109 'wp-includes/js/tinymce/themes/advanced/jscripts',
110 'wp-includes/js/tinymce/themes/advanced/langs',
111 'wp-includes/js/tinymce/tiny_mce_gzip.php',
112 'wp-includes/js/wp-ajax.js',
113 'wp-admin/admin-db.php',
114 'wp-admin/cat.js',
115 'wp-admin/categories.js',
116 'wp-admin/custom-fields.js',
117 'wp-admin/dbx-admin-key.js',
118 'wp-admin/edit-comments.js',
119 'wp-admin/install-rtl.css',
120 'wp-admin/install.css',
121 'wp-admin/upgrade-schema.php',
122 'wp-admin/upload-functions.php',
123 'wp-admin/upload-rtl.css',
124 'wp-admin/upload.css',
125 'wp-admin/upload.js',
126 'wp-admin/users.js',
127 'wp-admin/widgets-rtl.css',
128 'wp-admin/widgets.css',
129 'wp-admin/xfn.js',
130 'wp-includes/js/tinymce/license.html',
131 'wp-admin/cat-js.php',
132 'wp-admin/edit-form-ajax-cat.php',
133 'wp-admin/execute-pings.php',
134 'wp-admin/import/b2.php',
135 'wp-admin/import/btt.php',
136 'wp-admin/import/jkw.php',
137 'wp-admin/inline-uploading.php',
138 'wp-admin/link-categories.php',
139 'wp-admin/list-manipulation.js',
140 'wp-admin/list-manipulation.php',
141 'wp-includes/comment-functions.php',
142 'wp-includes/feed-functions.php',
143 'wp-includes/functions-compat.php',
144 'wp-includes/functions-formatting.php',
145 'wp-includes/functions-post.php',
146 'wp-includes/js/dbx-key.js',
147 'wp-includes/js/tinymce/plugins/autosave/langs/cs.js',
148 'wp-includes/js/tinymce/plugins/autosave/langs/sv.js',
149 'wp-includes/js/tinymce/themes/advanced/editor_template_src.js',
150 'wp-includes/links.php',
151 'wp-includes/pluggable-functions.php',
152 'wp-includes/template-functions-author.php',
153 'wp-includes/template-functions-category.php',
154 'wp-includes/template-functions-general.php',
155 'wp-includes/template-functions-links.php',
156 'wp-includes/template-functions-post.php',
157 'wp-includes/wp-l10n.php',
158 'wp-admin/import-b2.php',
159 'wp-admin/import-blogger.php',
160 'wp-admin/import-greymatter.php',
161 'wp-admin/import-livejournal.php',
162 'wp-admin/import-mt.php',
163 'wp-admin/import-rss.php',
164 'wp-admin/import-textpattern.php',
165 'wp-admin/quicktags.js',
166 'wp-images/fade-butt.png',
167 'wp-images/get-firefox.png',
168 'wp-images/header-shadow.png',
169 'wp-images/smilies',
170 'wp-images/wp-small.png',
171 'wp-images/wpminilogo.png',
172 'wp.php',
173 'wp-includes/gettext.php',
174 'wp-includes/streams.php',
175 // MU
176 'wp-admin/wpmu-admin.php',
177 'wp-admin/wpmu-blogs.php',
178 'wp-admin/wpmu-edit.php',
179 'wp-admin/wpmu-options.php',
180 'wp-admin/wpmu-themes.php',
181 'wp-admin/wpmu-upgrade-site.php',
182 'wp-admin/wpmu-users.php',
183 'wp-includes/wpmu-default-filters.php',
184 'wp-includes/wpmu-functions.php',
185 'wpmu-settings.php',
186 'index-install.php',
187 'README.txt',
188 'htaccess.dist',
189 'wp-admin/css/mu-rtl.css',
190 'wp-admin/css/mu.css',
191 'wp-admin/images/site-admin.png',
192 'wp-admin/includes/mu.php',
193 'wp-includes/images/wordpress-mu.png',
194 // 3.0
195 'wp-admin/categories.php',
196 'wp-admin/edit-category-form.php',
197 'wp-admin/edit-page-form.php',
198 'wp-admin/edit-pages.php',
199 'wp-admin/images/wp-logo.gif',
200 'wp-admin/js/wp-gears.dev.js',
201 'wp-admin/js/wp-gears.js',
202 'wp-admin/options-misc.php',
203 'wp-admin/page-new.php',
204 'wp-admin/page.php',
205 'wp-admin/rtl.css',
206 'wp-admin/rtl.dev.css',
207 'wp-admin/update-links.php',
208 'wp-admin/wp-admin.css',
209 'wp-admin/wp-admin.dev.css',
210 'wp-includes/js/codepress',
211 'wp-includes/js/jquery/autocomplete.dev.js',
212 'wp-includes/js/jquery/interface.js',
213 'wp-includes/js/jquery/autocomplete.js',
214 'wp-includes/js/scriptaculous/prototype.js',
215 'wp-includes/js/tinymce/wp-tinymce.js',
216 'wp-admin/import',
217 'wp-admin/images/ico-edit.png',
218 'wp-admin/images/fav-top.png',
219 'wp-admin/images/ico-close.png',
220 'wp-admin/images/admin-header-footer.png',
221 'wp-admin/images/screen-options-left.gif',
222 'wp-admin/images/ico-add.png',
223 'wp-admin/images/browse-happy.gif',
224 'wp-admin/images/ico-viewpage.png',
225 // 3.1
226 'wp-includes/js/tinymce/blank.htm',
227 'wp-includes/js/tinymce/plugins/safari',
228 'wp-admin/edit-link-categories.php',
229 'wp-admin/edit-post-rows.php',
230 'wp-admin/edit-attachment-rows.php',
231 'wp-admin/link-category.php',
232 'wp-admin/edit-link-category-form.php',
233 'wp-admin/sidebar.php',
234 'wp-admin/images/list-vs.png',
235 'wp-admin/images/button-grad-vs.png',
236 'wp-admin/images/button-grad-active-vs.png',
237 'wp-admin/images/fav-arrow-vs.gif',
238 'wp-admin/images/fav-arrow-vs-rtl.gif',
239 'wp-admin/images/fav-top-vs.gif',
240 'wp-admin/images/screen-options-right.gif',
241 'wp-admin/images/screen-options-right-up.gif',
242 'wp-admin/images/visit-site-button-grad-vs.gif',
243 'wp-admin/images/visit-site-button-grad.gif',
244 'wp-includes/classes.php',
245 // 3.2
246 'wp-includes/default-embeds.php',
247 'wp-includes/js/tinymce/plugins/wordpress/img/more.gif',
248 'wp-includes/js/tinymce/plugins/wordpress/img/toolbars.gif',
249 'wp-includes/js/tinymce/plugins/wordpress/img/help.gif',
250 'wp-includes/js/tinymce/themes/advanced/img/fm.gif',
251 'wp-includes/js/tinymce/themes/advanced/img/sflogo.png',
252 'wp-admin/js/list-table.js',
253 'wp-admin/js/list-table.dev.js',
254 'wp-admin/images/logo-login.gif',
255 'wp-admin/images/star.gif'
256 );
257
258 /**
259  * Stores new files in wp-content to copy
260  *
261  * The contents of this array indicate any new bundled plugins/themes which
262  * should be installed with the WordPress Upgrade. These items will not be
263  * re-installed in future upgrades, this behaviour is controlled by the
264  * introduced version present here being older than the current installed version.
265  *
266  * The content of this array should follow the following format:
267  *  Filename (relative to wp-content) => Introduced version
268  * Directories should be noted by suffixing it with a trailing slash (/)
269  *
270  * @since 3.2.0
271  * @global array $_new_bundled_files
272  * @var array
273  * @name $_new_bundled_files
274  */
275 global $_new_bundled_files;
276
277 $_new_bundled_files = array(
278 'plugins/akismet/' => '2.0',
279 'themes/twentyten/' => '3.0',
280 'themes/twentyeleven/' => '3.2'
281 );
282
283 /**
284  * Upgrade the core of WordPress.
285  *
286  * This will create a .maintenance file at the base of the WordPress directory
287  * to ensure that people can not access the web site, when the files are being
288  * copied to their locations.
289  *
290  * The files in the {@link $_old_files} list will be removed and the new files
291  * copied from the zip file after the database is upgraded.
292  *
293  * The files in the {@link $_new_bundled_files} list will be added to the installation
294  * if the version is greater than or equal to the old version being upgraded.
295  *
296  * The steps for the upgrader for after the new release is downloaded and
297  * unzipped is:
298  *   1. Test unzipped location for select files to ensure that unzipped worked.
299  *   2. Create the .maintenance file in current WordPress base.
300  *   3. Copy new WordPress directory over old WordPress files.
301  *   4. Upgrade WordPress to new version.
302  *     4.1. Copy all files/folders other than wp-content
303  *     4.2. Copy any language files to WP_LANG_DIR (which may differ from WP_CONTENT_DIR
304  *     4.3. Copy any new bundled themes/plugins to their respective locations
305  *   5. Delete new WordPress directory path.
306  *   6. Delete .maintenance file.
307  *   7. Remove old files.
308  *   8. Delete 'update_core' option.
309  *
310  * There are several areas of failure. For instance if PHP times out before step
311  * 6, then you will not be able to access any portion of your site. Also, since
312  * the upgrade will not continue where it left off, you will not be able to
313  * automatically remove old files and remove the 'update_core' option. This
314  * isn't that bad.
315  *
316  * If the copy of the new WordPress over the old fails, then the worse is that
317  * the new WordPress directory will remain.
318  *
319  * If it is assumed that every file will be copied over, including plugins and
320  * themes, then if you edit the default theme, you should rename it, so that
321  * your changes remain.
322  *
323  * @since 2.7.0
324  *
325  * @param string $from New release unzipped path.
326  * @param string $to Path to old WordPress installation.
327  * @return WP_Error|null WP_Error on failure, null on success.
328  */
329 function update_core($from, $to) {
330         global $wp_filesystem, $_old_files, $_new_bundled_files, $wpdb;
331
332         @set_time_limit( 300 );
333
334         $php_version    = phpversion();
335         $mysql_version  = $wpdb->db_version();
336         $required_php_version = '5.2.4';
337         $required_mysql_version = '5.0';
338         $wp_version = '3.2.1';
339         $php_compat     = version_compare( $php_version, $required_php_version, '>=' );
340         $mysql_compat   = version_compare( $mysql_version, $required_mysql_version, '>=' ) || file_exists( WP_CONTENT_DIR . '/db.php' );
341
342         if ( !$mysql_compat || !$php_compat )
343                 $wp_filesystem->delete($from, true);
344
345         if ( !$mysql_compat && !$php_compat )
346                 return new WP_Error( 'php_mysql_not_compatible', sprintf( __('The update cannot be installed because WordPress %1$s requires PHP version %2$s or higher and MySQL version %3$s or higher. You are running PHP version %4$s and MySQL version %5$s.'), $wp_version, $required_php_version, $required_mysql_version, $php_version, $mysql_version ) );
347         elseif ( !$php_compat )
348                 return new WP_Error( 'php_not_compatible', sprintf( __('The update cannot be installed because WordPress %1$s requires PHP version %2$s or higher. You are running version %3$s.'), $wp_version, $required_php_version, $php_version ) );
349         elseif ( !$mysql_compat )
350                 return new WP_Error( 'mysql_not_compatible', sprintf( __('The update cannot be installed because WordPress %1$s requires MySQL version %2$s or higher. You are running version %3$s.'), $wp_version, $required_mysql_version, $mysql_version ) );
351
352         // Sanity check the unzipped distribution
353         apply_filters('update_feedback', __('Verifying the unpacked files&#8230;'));
354         $distro = '';
355         $roots = array( '/wordpress/', '/wordpress-mu/' );
356         foreach( $roots as $root ) {
357                 if ( $wp_filesystem->exists($from . $root . 'readme.html') && $wp_filesystem->exists($from . $root . 'wp-includes/version.php') ) {
358                         $distro = $root;
359                         break;
360                 }
361         }
362         if ( !$distro ) {
363                 $wp_filesystem->delete($from, true);
364                 return new WP_Error('insane_distro', __('The update could not be unpacked') );
365         }
366
367         apply_filters('update_feedback', __('Installing the latest version&#8230;'));
368
369         // Create maintenance file to signal that we are upgrading
370         $maintenance_string = '<?php $upgrading = ' . time() . '; ?>';
371         $maintenance_file = $to . '.maintenance';
372         $wp_filesystem->delete($maintenance_file);
373         $wp_filesystem->put_contents($maintenance_file, $maintenance_string, FS_CHMOD_FILE);
374
375         // Copy new versions of WP files into place.
376         $result = _copy_dir($from . $distro, $to, array('wp-content') );
377
378         // Custom Content Directory needs updating now.
379         // Copy Languages
380         if ( !is_wp_error($result) && $wp_filesystem->is_dir($from . $distro . 'wp-content/languages') ) {
381                 if ( WP_LANG_DIR != ABSPATH . WPINC . '/languages' || @is_dir(WP_LANG_DIR) )
382                         $lang_dir = WP_LANG_DIR;
383                 else
384                         $lang_dir = WP_CONTENT_DIR . '/languages';
385
386                 if ( !@is_dir($lang_dir) && 0 === strpos($lang_dir, ABSPATH) ) { // Check the language directory exists first
387                         $wp_filesystem->mkdir($to . str_replace($lang_dir, ABSPATH, ''), FS_CHMOD_DIR); // If it's within the ABSPATH we can handle it here, otherwise they're out of luck.
388                         clearstatcache(); // for FTP, Need to clear the stat cache
389                 }
390
391                 if ( @is_dir($lang_dir) ) {
392                         $wp_lang_dir = $wp_filesystem->find_folder($lang_dir);
393                         if ( $wp_lang_dir )
394                                 $result = copy_dir($from . $distro . 'wp-content/languages/', $wp_lang_dir);
395                 }
396         }
397
398         // Copy New bundled plugins & themes
399         // This gives us the ability to install new plugins & themes bundled with future versions of WordPress whilst avoiding the re-install upon upgrade issue.
400         if ( !is_wp_error($result) && ( ! defined('CORE_UPGRADE_SKIP_NEW_BUNDLED') || ! CORE_UPGRADE_SKIP_NEW_BUNDLED ) ) {
401                 $old_version = $GLOBALS['wp_version']; // $wp_version in local scope == new version
402                 foreach ( (array) $_new_bundled_files as $file => $introduced_version ) {
403                         // If $introduced version is greater than what the site was previously running
404                         if ( version_compare($introduced_version, $old_version, '>') ) {
405                                 $directory = ('/' == $file[ strlen($file)-1 ]);
406                                 list($type, $filename) = explode('/', $file, 2);
407
408                                 if ( 'plugins' == $type )
409                                         $dest = $wp_filesystem->wp_plugins_dir();
410                                 elseif ( 'themes' == $type )
411                                         $dest = trailingslashit($wp_filesystem->wp_themes_dir()); // Back-compat, ::wp_themes_dir() did not return trailingslash'd pre-3.2
412                                 else
413                                         continue;
414
415                                 if ( ! $directory ) {
416                                         if ( $wp_filesystem->exists($dest . $filename) )
417                                                 continue;
418
419                                         if ( ! $wp_filesystem->copy($from . $distro . 'wp-content/' . $file, $dest . $filename, FS_CHMOD_FILE) )
420                                                 $result = new WP_Error('copy_failed', __('Could not copy file.'), $dest . $filename);
421                                 } else {
422                                         if ( $wp_filesystem->is_dir($dest . $filename) )
423                                                 continue;
424
425                                         $wp_filesystem->mkdir($dest . $filename, FS_CHMOD_DIR);
426                                         $_result = copy_dir( $from . $distro . 'wp-content/' . $file, $dest . $filename);
427                                         if ( is_wp_error($_result) ) //If a error occurs partway through this final step, keep the error flowing through, but keep process going.
428                                                 $result = $_result;
429                                 }
430                         }
431                 } //end foreach
432         }
433
434         // Handle $result error from the above blocks
435         if ( is_wp_error($result) ) {
436                 $wp_filesystem->delete($maintenance_file);
437                 $wp_filesystem->delete($from, true);
438                 return $result;
439         }
440
441         // Remove old files
442         foreach ( $_old_files as $old_file ) {
443                 $old_file = $to . $old_file;
444                 if ( !$wp_filesystem->exists($old_file) )
445                         continue;
446                 $wp_filesystem->delete($old_file, true);
447         }
448
449         // Upgrade DB with separate request
450         apply_filters('update_feedback', __('Upgrading database&#8230;'));
451         $db_upgrade_url = admin_url('upgrade.php?step=upgrade_db');
452         wp_remote_post($db_upgrade_url, array('timeout' => 60));
453
454         // Remove working directory
455         $wp_filesystem->delete($from, true);
456
457         // Force refresh of update information
458         if ( function_exists('delete_site_transient') )
459                 delete_site_transient('update_core');
460         else
461                 delete_option('update_core');
462
463         // Remove maintenance file, we're done.
464         $wp_filesystem->delete($maintenance_file);
465 }
466
467 /**
468  * Copies a directory from one location to another via the WordPress Filesystem Abstraction.
469  * Assumes that WP_Filesystem() has already been called and setup.
470  *
471  * This is a temporary function for the 3.1 -> 3.2 upgrade only and will be removed in 3.3
472  *
473  * @ignore
474  * @since 3.2.0
475  * @see copy_dir()
476  *
477  * @param string $from source directory
478  * @param string $to destination directory
479  * @param array $skip_list a list of files/folders to skip copying
480  * @return mixed WP_Error on failure, True on success.
481  */
482 function _copy_dir($from, $to, $skip_list = array() ) {
483         global $wp_filesystem;
484
485         $dirlist = $wp_filesystem->dirlist($from);
486
487         $from = trailingslashit($from);
488         $to = trailingslashit($to);
489
490         $skip_regex = '';
491         foreach ( (array)$skip_list as $key => $skip_file )
492                 $skip_regex .= preg_quote($skip_file, '!') . '|';
493
494         if ( !empty($skip_regex) )
495                 $skip_regex = '!(' . rtrim($skip_regex, '|') . ')$!i';
496
497         foreach ( (array) $dirlist as $filename => $fileinfo ) {
498                 if ( !empty($skip_regex) )
499                         if ( preg_match($skip_regex, $from . $filename) )
500                                 continue;
501
502                 if ( 'f' == $fileinfo['type'] ) {
503                         if ( ! $wp_filesystem->copy($from . $filename, $to . $filename, true, FS_CHMOD_FILE) ) {
504                                 // If copy failed, chmod file to 0644 and try again.
505                                 $wp_filesystem->chmod($to . $filename, 0644);
506                                 if ( ! $wp_filesystem->copy($from . $filename, $to . $filename, true, FS_CHMOD_FILE) )
507                                         return new WP_Error('copy_failed', __('Could not copy file.'), $to . $filename);
508                         }
509                 } elseif ( 'd' == $fileinfo['type'] ) {
510                         if ( !$wp_filesystem->is_dir($to . $filename) ) {
511                                 if ( !$wp_filesystem->mkdir($to . $filename, FS_CHMOD_DIR) )
512                                         return new WP_Error('mkdir_failed', __('Could not create directory.'), $to . $filename);
513                         }
514                         $result = _copy_dir($from . $filename, $to . $filename, $skip_list);
515                         if ( is_wp_error($result) )
516                                 return $result;
517                 }
518         }
519         return true;
520 }
521
522 ?>