maintenance/importTextFile.php

   1 <?php
   2 /**
   3  * Create or edit pages using the contents of a text file.
   4  *
   5  * This program is free software; you can redistribute it and/or modify
   6  * it under the terms of the GNU General Public License as published by
   7  * the Free Software Foundation; either version 2 of the License, or
   8  * (at your option) any later version.
   9  *
  10  * This program is distributed in the hope that it will be useful,
  11  * but WITHOUT ANY WARRANTY; without even the implied warranty of
  12  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
  13  * GNU General Public License for more details.
  14  *
  15  * You should have received a copy of the GNU General Public License along
  16  * with this program; if not, write to the Free Software Foundation, Inc.,
  17  * 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
  18  * http://www.gnu.org/copyleft/gpl.html
  19  *
  20  * @file
  21  * @ingroup Maintenance
  22  * @author Rob Church <robchur@gmail.com>
  23  */
  24
  25 $options = array( 'help', 'nooverwrite', 'norc' );
  26 $optionsWithArgs = array( 'title', 'user', 'comment' );
  27 require_once __DIR__ . '/commandLine.inc';
  28 echo "Import Text File\n\n";
  29
  30 if ( count( $args ) < 1 || isset( $options['help'] ) ) {
  31         showHelp();
  32 } else {
  33
  34         $filename = $args[0];
  35         echo "Using {$filename}...";
  36         if ( is_file( $filename ) ) {
  37
  38                 $title = isset( $options['title'] ) ? $options['title'] : titleFromFilename( $filename );
  39                 $title = Title::newFromURL( $title );
  40
  41                 if ( is_object( $title ) ) {
  42
  43                         echo "\nUsing title '" . $title->getPrefixedText() . "'...";
  44                         if ( !$title->exists() || !isset( $options['nooverwrite'] ) ) {
  45
  46                                 $text = file_get_contents( $filename );
  47                                 $user = isset( $options['user'] ) ? $options['user'] : 'Maintenance script';
  48                                 $user = User::newFromName( $user );
  49
  50                                 if ( is_object( $user ) ) {
  51
  52                                         echo "\nUsing username '" . $user->getName() . "'...";
  53                                         $wgUser =& $user;
  54                                         $comment = isset( $options['comment'] ) ? $options['comment'] : 'Importing text file';
  55                                         $flags = 0 | ( isset( $options['norc'] ) ? EDIT_SUPPRESS_RC : 0 );
  56
  57                                         echo "\nPerforming edit...";
  58                                         $page = WikiPage::factory( $title );
  59                                         $content = ContentHandler::makeContent( $text, $title );
  60                                         $page->doEditContent( $content, $comment, $flags, false, $user );
  61                                         echo "done.\n";
  62
  63                                 } else {
  64                                         echo "invalid username.\n";
  65                                 }
  66
  67                         } else {
  68                                 echo "page exists.\n";
  69                         }
  70
  71                 } else {
  72                         echo "invalid title.\n";
  73                 }
  74
  75         } else {
  76                 echo "does not exist.\n";
  77         }
  78
  79 }
  80
  81 function titleFromFilename( $filename ) {
  82         $parts = explode( '/', $filename );
  83         $parts = explode( '.', $parts[ count( $parts ) - 1 ] );
  84         return $parts[0];
  85 }
  86
  87 function showHelp() {
  88 print <<<EOF
  89 USAGE: php importTextFile.php <options> <filename>
  90
  91 <filename> : Path to the file containing page content to import
  92
  93 Options:
  94
  95 --title <title>
  96         Title for the new page; default is to use the filename as a base
  97 --user <user>
  98         User to be associated with the edit
  99 --comment <comment>
 100         Edit summary
 101 --nooverwrite
 102         Don't overwrite existing content
 103 --norc
 104         Don't update recent changes
 105 --help
 106         Show this information
 107
 108 EOF;
 109 }