Localisation updates for core and extension messages from translatewiki.net
[lhc/web/wiklou.git] / maintenance / importTextFile.php
index 33e6d3c..b78ae03 100644 (file)
@@ -4,59 +4,75 @@
  * Maintenance script allows creating or editing pages using
  * the contents of a text file
  *
- * @addtogroup Maintenance
+ * This program is free software; you can redistribute it and/or modify
+ * it under the terms of the GNU General Public License as published by
+ * the Free Software Foundation; either version 2 of the License, or
+ * (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+ * GNU General Public License for more details.
+ *
+ * You should have received a copy of the GNU General Public License along
+ * with this program; if not, write to the Free Software Foundation, Inc.,
+ * 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
+ * http://www.gnu.org/copyleft/gpl.html
+ *
+ * @file
+ * @ingroup Maintenance
  * @author Rob Church <robchur@gmail.com>
  */
-$options = array( 'help', 'nooverwrite' ); 
+
+$options = array( 'help', 'nooverwrite', 'norc' );
 $optionsWithArgs = array( 'title', 'user', 'comment' );
-require_once( 'commandLine.inc' );
+require_once( dirname( __FILE__ ) . '/commandLine.inc' );
 echo( "Import Text File\n\n" );
 
-if( isset( $options['help'] ) ) {
+if ( count( $args ) < 1 || isset( $options['help'] ) ) {
        showHelp();
 } else {
 
        $filename = $args[0];
        echo( "Using {$filename}..." );
-       if( is_file( $filename ) ) {
-               
+       if ( is_file( $filename ) ) {
+
                $title = isset( $options['title'] ) ? $options['title'] : titleFromFilename( $filename );
-               $title = Title::newFromUrl( $title );
-               echo( "\nUsing title '" . $title->getPrefixedText() . "'..." );
-               
-               if( is_object( $title ) ) {
-                       
-                       if( !$title->exists() || !isset( $options['nooverwrite'] ) ) {
-                       
+               $title = Title::newFromURL( $title );
+
+               if ( is_object( $title ) ) {
+
+                       echo( "\nUsing title '" . $title->getPrefixedText() . "'..." );
+                       if ( !$title->exists() || !isset( $options['nooverwrite'] ) ) {
+
                                $text = file_get_contents( $filename );
-                               $user = isset( $options['user'] ) ? $options['user'] : 'MediaWiki default';
+                               $user = isset( $options['user'] ) ? $options['user'] : 'Maintenance script';
                                $user = User::newFromName( $user );
-                               echo( "\nUsing username '" . $user->getName() . "'..." );
-                               
-                               if( is_object( $user ) ) {
-                               
+
+                               if ( is_object( $user ) ) {
+
+                                       echo( "\nUsing username '" . $user->getName() . "'..." );
                                        $wgUser =& $user;
                                        $comment = isset( $options['comment'] ) ? $options['comment'] : 'Importing text file';
-                                       $comment = str_replace( '_', ' ', $comment );
-                                       
+                                       $flags = 0 | ( isset( $options['norc'] ) ? EDIT_SUPPRESS_RC : 0 );
+
                                        echo( "\nPerforming edit..." );
                                        $article = new Article( $title );
-                                       $article->doEdit( $text, $comment );
+                                       $article->doEdit( $text, $comment, $flags );
                                        echo( "done.\n" );
-                               
+
                                } else {
                                        echo( "invalid username.\n" );
                                }
-                       
+
                        } else {
                                echo( "page exists.\n" );
                        }
-                       
+
                } else {
                        echo( "invalid title.\n" );
                }
-               
+
        } else {
                echo( "does not exist.\n" );
        }
@@ -70,14 +86,25 @@ function titleFromFilename( $filename ) {
 }
 
 function showHelp() {
-       echo( "Import the contents of a text file into a wiki page.\n\n" );
-       echo( "USAGE: php importTextFile.php [--help|--title <title>|--user <user>|--comment <comment>|--nooverwrite] <filename>\n\n" );
-       echo( "              --help: Show this help information\n" );
-       echo( "    --title <title> : Title for the new page; if not supplied, the filename is used as a base for the title\n" );
-       echo( "      --user <user> : User to be associated with the edit; if not supplied, a default is used\n" );
-       echo( "--comment <comment> : Edit summary to be associated with the edit; underscores are transformed into spaces; if not supplied, a default is used\n" );
-       echo( "      --nooverwrite : Don't overwrite existing page content\n" );
-       echo( "         <filename> : Path to the file containing the wikitext to import\n\n" );
-}
+print <<<EOF
+USAGE: php importTextFile.php <options> <filename>
+
+<filename> : Path to the file containing page content to import
+
+Options:
 
-?>
\ No newline at end of file
+--title <title>
+       Title for the new page; default is to use the filename as a base
+--user <user>
+       User to be associated with the edit
+--comment <comment>
+       Edit summary
+--nooverwrite
+       Don't overwrite existing content
+--norc
+       Don't update recent changes
+--help
+       Show this information
+
+EOF;
+}