Index: tags/extensions/Push/REL_0_3/Push.i18n.php |
— | — | @@ -0,0 +1,208 @@ |
| 2 | +<?php |
| 3 | + |
| 4 | +/** |
| 5 | + * Internationalization file for the Push extension. |
| 6 | + * |
| 7 | + * @file Push.i18n.php |
| 8 | + * @ingroup Push |
| 9 | + * |
| 10 | + * @author Jeroen De Dauw < jeroendedauw@gmail.com > |
| 11 | + */ |
| 12 | + |
| 13 | +$messages = array(); |
| 14 | + |
| 15 | +/** English |
| 16 | + * @author Jeroen De Dauw |
| 17 | + */ |
| 18 | +$messages['en'] = array( |
| 19 | + 'push-desc' => 'Lightweight extension to push content to other wikis', |
| 20 | + |
| 21 | + 'right-push' => 'Authorization to use push functionality.', |
| 22 | + 'right-bulkpush' => 'Authorization to use bulk push functionality (ie Special:Push).', |
| 23 | + 'right-pushadmin' => 'Authorization to modify push targets and push settings.', |
| 24 | + |
| 25 | + 'push-err-captacha' => 'Could not push to $1 due to captcha.', |
| 26 | + |
| 27 | + // Tab |
| 28 | + 'push-tab-text' => 'Push', |
| 29 | + 'push-button-text' => 'Push', |
| 30 | + 'push-tab-desc' => 'This tab allows you to push the current revision of this page to one or more other wikis.', |
| 31 | + 'push-button-pushing' => 'Pushing', |
| 32 | + 'push-button-completed' => 'Push completed', |
| 33 | + 'push-button-failed' => 'Push failed', |
| 34 | + 'push-tab-title' => 'Pushing $1', |
| 35 | + 'push-targets' => 'Push targets', |
| 36 | + 'push-add-target' => 'Add target', |
| 37 | + 'push-import-revision-message' => 'Import from $1 by $2. $3', |
| 38 | + 'push-import-revision-comment' => 'Last comment: $1', |
| 39 | + 'push-tab-no-targets' => 'There are no targets to push to. Please add some to your LocalSettings.php file.', |
| 40 | + 'push-tab-push-to' => 'Push to $1', |
| 41 | + 'push-remote-pages' => 'Remote pages', |
| 42 | + 'push-remote-page-link' => '$1 on $2', |
| 43 | + 'push-remote-page-link-full' => 'View $1 on $2', |
| 44 | + 'push-targets-total' => 'There a total of $1 {{PLURAL:$1|target|targets}}.', |
| 45 | + 'push-button-all' => 'Push all', |
| 46 | + |
| 47 | + // Special page |
| 48 | + 'special-push' => 'Push pages', |
| 49 | + 'push-special-description' => 'This page enables you to push content of one or more pages to one or more MediaWiki wikis. |
| 50 | + |
| 51 | +To push pages, enter the titles in the text box below, one title per line and hit push all. This can take a while to complete.', |
| 52 | + 'push-special-pushing-desc' => 'Pushing $2 {{PLURAL:$2|page|pages}} to $1...', |
| 53 | + 'push-special-button-text' => 'Push pages', |
| 54 | + 'push-special-target-is' => 'Target wiki: $1', |
| 55 | + 'push-special-select-targets' => 'Target wikis:', |
| 56 | + 'push-special-item-pushing' => '$1: Pushing', |
| 57 | + 'push-special-item-completed' => '$1: Push completed', |
| 58 | + 'push-special-item-failed' => '$1: Push failed: $2', |
| 59 | + 'push-special-push-done' => 'Push completed', |
| 60 | + 'push-special-err-token-failed' => 'Could not obtain an edit token on the target wiki.', |
| 61 | + 'push-special-err-pageget-failed' => 'Could not obtain local page content.', |
| 62 | + 'push-special-err-push-failed' => 'Target wiki refused the pushed page.' |
| 63 | +); |
| 64 | + |
| 65 | +/** Message documentation (Message documentation) */ |
| 66 | +$messages['qqq'] = array( |
| 67 | + 'push-import-revision-message' => '$3 is [[MediaWiki:Push-import-revision-comment]] or empty.', |
| 68 | + 'push-remote-page-link' => '$1: page name, $2: wiki name', |
| 69 | + 'push-remote-page-link-full' => '$1: page name, $2: wiki name', |
| 70 | +); |
| 71 | + |
| 72 | +/** Belarusian (Taraškievica orthography) (Беларуская (тарашкевіца)) |
| 73 | + * @author EugeneZelenko |
| 74 | + * @author Jim-by |
| 75 | + */ |
| 76 | +$messages['be-tarask'] = array( |
| 77 | + 'push-desc' => 'Невялікае пашырэньне для распаўсюджваньня зьместу ў іншыя вікі', |
| 78 | + 'push-tab-text' => 'Распаўсюдзіць', |
| 79 | + 'push-button-text' => 'Распаўсюдзіць', |
| 80 | + 'push-tab-desc' => 'Гэтая закладка дазваляе Вам распаўсюджваць цяперашнюю вэрсію гэтай старонкі ў іншыя вікі.', |
| 81 | + 'push-button-pushing' => 'Распаўсюджваньне', |
| 82 | + 'push-button-completed' => 'Распаўсюджваньне скончанае', |
| 83 | + 'push-button-failed' => 'Памылка распаўсюджваньня', |
| 84 | + 'push-tab-title' => 'Распаўсюджваньне $1', |
| 85 | + 'push-targets' => 'Мэты распаўсюджваньня', |
| 86 | + 'push-add-target' => 'Дадаць мэту', |
| 87 | +); |
| 88 | + |
| 89 | +/** German (Deutsch) |
| 90 | + * @author Kghbln |
| 91 | + */ |
| 92 | +$messages['de'] = array( |
| 93 | + 'push-desc' => 'Ermöglicht den einfachen Transfer von Inhalten eines Wikis in ein anderes', |
| 94 | + 'push-tab-text' => 'Transferieren', |
| 95 | + 'push-button-text' => 'Transferieren', |
| 96 | + 'push-tab-desc' => 'Dieser Reiter ermöglicht den Transfer des aktuellen Seiteninhalts in ein oder mehrere andere Wikis.', |
| 97 | + 'push-button-pushing' => 'Transferiere', |
| 98 | + 'push-button-completed' => 'Transfer abgeschlossen', |
| 99 | + 'push-button-failed' => 'Transfer fehlgeschlagen', |
| 100 | + 'push-tab-title' => 'Transferiere $1', |
| 101 | + 'push-targets' => 'Transferziele', |
| 102 | + 'push-add-target' => 'Transferziel hinzufügen', |
| 103 | + 'push-import-revision-message' => 'Import von $1 durch Benutzer $2. $3', |
| 104 | + 'push-import-revision-comment' => 'Letzter Kommentar: $1', |
| 105 | + 'push-tab-no-targets' => 'Es sind keine Transferziele vorhanden. Es müssen welche in der Datei LocalSettings.php definiert werden.', |
| 106 | + 'push-tab-push-to' => 'Transferiere nach $1', |
| 107 | + 'push-remote-pages' => 'Entfernte Seiten', |
| 108 | + 'push-remote-page-link' => 'Seite $1 auf Wiki $2', |
| 109 | + 'push-remote-page-link-full' => 'Seite $1 auf Wiki $2 ansehen', |
| 110 | + 'push-targets-total' => 'Es {{PLURAL:$1|ist|sind}} insgesamt $1 {{PLURAL:$1|Transferziel|Transferziele}} vorhanden.', |
| 111 | + 'push-button-all' => 'Alle transferieren', |
| 112 | + 'special-push' => 'Seiten transferieren', |
| 113 | + 'push-special-description' => 'Diese Spezialseite ermöglicht es den Inhalt einer oder mehrerer Seiten zu einem oder mehreren anderen Wikis zu transferieren. |
| 114 | + |
| 115 | +Um Seiten zu transferieren, sind deren Titel im Eingabefeld unten anzugeben (ein Titel pro Zeile). Klicke danach auf „{{int:push-special-button-text}}“. Es kann etwas dauern, bis der Transfer abgeschlossen ist.', |
| 116 | + 'push-special-pushing-desc' => 'Transferiere $2 {{PLURAL:$2|Seite|Seiten}} nach $1 …', |
| 117 | + 'push-special-button-text' => 'Seiten transferieren', |
| 118 | + 'push-special-target-is' => 'Zielwiki: $1', |
| 119 | + 'push-special-select-targets' => 'Zielwikis:', |
| 120 | + 'push-special-item-getting' => '$1: Seite wird geholt', |
| 121 | + 'push-special-item-pushing-to' => '$1: Transferiere nach $2', |
| 122 | + 'push-special-item-completed' => '$1: Transfer abgeschlossen', |
| 123 | + 'push-special-item-failed' => '$1: Transfer fehlgeschlagen. Grund: $2', |
| 124 | + 'push-special-push-done' => 'Transfer abgeschlossen', |
| 125 | +); |
| 126 | + |
| 127 | +/** Interlingua (Interlingua) |
| 128 | + * @author McDutchie |
| 129 | + */ |
| 130 | +$messages['ia'] = array( |
| 131 | + 'push-desc' => 'Extension simple pro transferer contento a altere wikis', |
| 132 | + 'push-tab-text' => 'Transferer', |
| 133 | + 'push-button-text' => 'Transferer', |
| 134 | + 'push-tab-desc' => 'Iste scheda permitte transferer le version actual de iste pagina a un o plus altere wikis.', |
| 135 | + 'push-button-pushing' => 'Transferimento in curso', |
| 136 | + 'push-button-completed' => 'Transferimento complete', |
| 137 | + 'push-button-failed' => 'Transferimento fallite', |
| 138 | + 'push-tab-title' => 'Transfere $1', |
| 139 | + 'push-targets' => 'Destinationes de transferimento', |
| 140 | + 'push-add-target' => 'Adder destination', |
| 141 | + 'push-import-revision-message' => 'Importation ex $1 per $2. $3', |
| 142 | + 'push-import-revision-comment' => 'Ultime commento: $1', |
| 143 | + 'push-tab-no-targets' => 'Il non ha destinationes de transferimento. Per favor adde alcunes in tu file LocalSettings.php.', |
| 144 | + 'push-tab-push-to' => 'Transferer a $1', |
| 145 | + 'push-remote-pages' => 'Paginas remote', |
| 146 | + 'push-remote-page-link' => '$1 in $2', |
| 147 | + 'push-remote-page-link-full' => 'Vider $1 in $2', |
| 148 | + 'push-targets-total' => 'Il ha un total de $1 {{PLURAL:$1|destination|destinationes}}.', |
| 149 | + 'push-button-all' => 'Transferer totes', |
| 150 | + 'special-push' => 'Transferer paginas', |
| 151 | + 'push-special-description' => 'Iste pagina permitte transferer le contento de un o plus paginas a un o plus wikis MediaWiki. |
| 152 | + |
| 153 | +Pro transferer paginas, entra le titulos in le quadro de texto hic infra, un titulo per linea, e preme "Transferer totes". Isto pote prender certe un tempore.', |
| 154 | + 'push-special-pushing-desc' => 'Transfere $2 {{PLURAL:$2|pagina|paginas}} a $1...', |
| 155 | + 'push-special-button-text' => 'Transferer paginas', |
| 156 | + 'push-special-target-is' => 'Wiki de destination: $1', |
| 157 | + 'push-special-select-targets' => 'Wikis de destination:', |
| 158 | + 'push-special-item-getting' => '$1: Obtene pagina', |
| 159 | + 'push-special-item-pushing-to' => '$1: Transfere a $2', |
| 160 | + 'push-special-item-completed' => '$1: Transferimento complete', |
| 161 | + 'push-special-item-failed' => '$1: Transferimento fallite: $2', |
| 162 | + 'push-special-push-done' => 'Transferimento complete', |
| 163 | +); |
| 164 | + |
| 165 | +/** Macedonian (Македонски) |
| 166 | + * @author Bjankuloski06 |
| 167 | + */ |
| 168 | +$messages['mk'] = array( |
| 169 | + 'push-desc' => 'Мал додаток за пренесување на содржини од едно на други викија', |
| 170 | + 'push-tab-text' => 'Пренеси', |
| 171 | + 'push-button-text' => 'Пренеси', |
| 172 | + 'push-tab-desc' => 'Ова јазиче ви овозможува да ја пренесете тековната ревизија на страницава на едно или повеќе викија', |
| 173 | + 'push-button-pushing' => 'Пренесувам', |
| 174 | + 'push-button-completed' => 'Преносот заврши', |
| 175 | + 'push-button-failed' => 'Преносот не успеа', |
| 176 | + 'push-tab-title' => 'Пренесување на $1', |
| 177 | + 'push-targets' => 'Пренеси цели', |
| 178 | + 'push-add-target' => 'Додај цел', |
| 179 | + 'push-import-revision-message' => 'Увоз од $1. Увозник: $2. $3', |
| 180 | + 'push-import-revision-comment' => 'Последен коментар: $1', |
| 181 | + 'push-tab-no-targets' => 'Нема целни места за пренос. Додајте места во вашата податотека LocalSettings.php.', |
| 182 | + 'push-tab-push-to' => 'Пренеси во $1', |
| 183 | + 'push-remote-pages' => 'Далечински страници', |
| 184 | + 'push-remote-page-link' => '$1 на $2', |
| 185 | + 'push-remote-page-link-full' => 'Преглед на $1 на $2', |
| 186 | + 'push-targets-total' => 'Има вкупно $1 {{PLURAL:$1|цел|цели}}.', |
| 187 | + 'push-button-all' => 'Пренеси сè', |
| 188 | + 'special-push' => 'Пренесување страници', |
| 189 | + 'push-special-description' => 'Оваа страница ви овозможува да пренесете содржини од една или повеќе страници од едно вики во едно или повеќе викија што работат на МедијаВики. |
| 190 | + |
| 191 | +За да пренесете, внесете ги насловите во полето подолу, по едно во секој ред, па стиснете на „Пренеси сè“. Ова може да потрае.', |
| 192 | + 'push-special-pushing-desc' => 'Пренесувам $2 {{PLURAL:$2|страница|страници}} во $1...', |
| 193 | + 'push-special-button-text' => 'Пренеси', |
| 194 | + 'push-special-target-is' => 'Целно вики: $1', |
| 195 | + 'push-special-select-targets' => 'Целни викија:', |
| 196 | + 'push-special-item-getting' => '$1: Ја преземам страницата', |
| 197 | + 'push-special-item-pushing-to' => '$1: Пренесуавам во $2', |
| 198 | + 'push-special-item-completed' => '$1: Преносот заврши', |
| 199 | + 'push-special-item-failed' => '$1: Преносот не успеа: $2', |
| 200 | + 'push-special-push-done' => 'Преносот заврши', |
| 201 | +); |
| 202 | + |
| 203 | +/** Russian (Русский) |
| 204 | + * @author Lockal |
| 205 | + */ |
| 206 | +$messages['ru'] = array( |
| 207 | + 'push-import-revision-comment' => 'Последний комментарий: $1', |
| 208 | +); |
| 209 | + |
Property changes on: tags/extensions/Push/REL_0_3/Push.i18n.php |
___________________________________________________________________ |
Added: svn:eol-style |
1 | 210 | + native |
Index: tags/extensions/Push/REL_0_3/specials/Push_Body.php |
— | — | @@ -0,0 +1,388 @@ |
| 2 | +<?php |
| 3 | + |
| 4 | +/** |
| 5 | + * A special page that allows pushing one or more pages to one or more targets. |
| 6 | + * Partly based on MediaWiki's Special:Export. |
| 7 | + * |
| 8 | + * @since 0.1 |
| 9 | + * |
| 10 | + * @file Push_Body.php |
| 11 | + * @ingroup Push |
| 12 | + * |
| 13 | + * @author Jeroen De Dauw < jeroendedauw@gmail.com > |
| 14 | + */ |
| 15 | +class SpecialPush extends SpecialPage { |
| 16 | + |
| 17 | + /** |
| 18 | + * Constructor. |
| 19 | + * |
| 20 | + * @since 0.1 |
| 21 | + */ |
| 22 | + public function __construct() { |
| 23 | + parent::__construct( 'Push', 'bulkpush' ); |
| 24 | + } |
| 25 | + |
| 26 | + /** |
| 27 | + * @see SpecialPage::getDescription |
| 28 | + */ |
| 29 | + public function getDescription() { |
| 30 | + return wfMsg( 'special-' . strtolower( $this->mName ) ); |
| 31 | + } |
| 32 | + |
| 33 | + /** |
| 34 | + * Sets headers - this should be called from the execute() method of all derived classes! |
| 35 | + */ |
| 36 | + public function setHeaders() { |
| 37 | + global $wgOut; |
| 38 | + $wgOut->setArticleRelated( false ); |
| 39 | + $wgOut->setRobotPolicy( "noindex,nofollow" ); |
| 40 | + $wgOut->setPageTitle( $this->getDescription() ); |
| 41 | + } |
| 42 | + |
| 43 | + /** |
| 44 | + * Main method. |
| 45 | + * |
| 46 | + * @since 0.1 |
| 47 | + * |
| 48 | + * @param string $arg |
| 49 | + */ |
| 50 | + public function execute( $arg ) { |
| 51 | + global $wgOut, $wgUser, $wgRequest, $egPushTargets; |
| 52 | + |
| 53 | + $this->setHeaders(); |
| 54 | + $this->outputHeader(); |
| 55 | + |
| 56 | + // If the user is authorized, display the page, if not, show an error. |
| 57 | + if ( !$this->userCanExecute( $wgUser ) ) { |
| 58 | + $this->displayRestrictionError(); |
| 59 | + return; |
| 60 | + } |
| 61 | + |
| 62 | + if ( count( $egPushTargets ) == 0 ) { |
| 63 | + $wgOut->addHTML( '<p>' . htmlspecialchars( wfMsg( 'push-tab-no-targets' ) ) . '</p>' ); |
| 64 | + return; |
| 65 | + } |
| 66 | + |
| 67 | + $doPush = false; |
| 68 | + |
| 69 | + if ( $wgRequest->getCheck( 'addcat' ) ) { |
| 70 | + $pages = $wgRequest->getText( 'pages' ); |
| 71 | + $catname = $wgRequest->getText( 'catname' ); |
| 72 | + |
| 73 | + if ( $catname !== '' && $catname !== null && $catname !== false ) { |
| 74 | + $t = Title::makeTitleSafe( NS_MAIN, $catname ); |
| 75 | + if ( $t ) { |
| 76 | + /** |
| 77 | + * @todo Fixme: this can lead to hitting memory limit for very large |
| 78 | + * categories. Ideally we would do the lookup synchronously |
| 79 | + * during the export in a single query. |
| 80 | + */ |
| 81 | + $catpages = $this->getPagesFromCategory( $t ); |
| 82 | + if ( $catpages ) $pages .= "\n" . implode( "\n", $catpages ); |
| 83 | + } |
| 84 | + } |
| 85 | + } |
| 86 | + else if( $wgRequest->getCheck( 'addns' ) ) { |
| 87 | + $pages = $wgRequest->getText( 'pages' ); |
| 88 | + $nsindex = $wgRequest->getText( 'nsindex', '' ); |
| 89 | + |
| 90 | + if ( strval( $nsindex ) !== '' ) { |
| 91 | + /** |
| 92 | + * Same implementation as above, so same @todo |
| 93 | + */ |
| 94 | + $nspages = $this->getPagesFromNamespace( $nsindex ); |
| 95 | + if ( $nspages ) $pages .= "\n" . implode( "\n", $nspages ); |
| 96 | + } |
| 97 | + } |
| 98 | + else if( $wgRequest->wasPosted() ) { |
| 99 | + $pages = $wgRequest->getText( 'pages' ); |
| 100 | + if( $pages != '' ) $doPush= true; |
| 101 | + } |
| 102 | + else { |
| 103 | + $pages = ''; |
| 104 | + } |
| 105 | + |
| 106 | + if ( $doPush ) { |
| 107 | + $this->doPush( $pages ); |
| 108 | + } |
| 109 | + else { |
| 110 | + $this->displayPushInterface( $arg, $pages ); |
| 111 | + } |
| 112 | + } |
| 113 | + |
| 114 | + /** |
| 115 | + * Outputs the HTML to indicate a push is occuring and |
| 116 | + * the JavaScript to needed by the push. |
| 117 | + * |
| 118 | + * @since 0.2 |
| 119 | + * |
| 120 | + * @param string $pages |
| 121 | + */ |
| 122 | + protected function doPush( $pages ) { |
| 123 | + global $wgOut, $wgLang, $wgRequest, $wgSitename, $egPushTargets, $egPushBulkWorkers, $egPushBatchSize; |
| 124 | + |
| 125 | + $pageSet = array(); // Inverted index of all pages to look up |
| 126 | + |
| 127 | + // Split up and normalize input |
| 128 | + foreach( explode( "\n", $pages ) as $pageName ) { |
| 129 | + $pageName = trim( $pageName ); |
| 130 | + $title = Title::newFromText( $pageName ); |
| 131 | + if( $title && $title->getInterwiki() == '' && $title->getText() !== '' ) { |
| 132 | + // Only record each page once! |
| 133 | + $pageSet[$title->getPrefixedText()] = true; |
| 134 | + } |
| 135 | + } |
| 136 | + |
| 137 | + // Look up any linked pages if asked... |
| 138 | + if( $wgRequest->getCheck( 'templates' ) ) { |
| 139 | + $pageSet = $this->getTemplates( array_keys( $pageSet ), $pageSet ); |
| 140 | + } |
| 141 | + |
| 142 | + $pages = array_keys( $pageSet ); |
| 143 | + |
| 144 | + $targets = array(); |
| 145 | + $links = array(); |
| 146 | + |
| 147 | + if ( count( $egPushTargets ) > 1 ) { |
| 148 | + foreach ( $egPushTargets as $targetName => $targetUrl ) { |
| 149 | + if ( $wgRequest->getCheck( str_replace( ' ', '_', $targetName ) ) ) { |
| 150 | + $targets[$targetName] = $targetUrl; |
| 151 | + $links[] = "[$targetUrl $targetName]"; |
| 152 | + } |
| 153 | + } |
| 154 | + } |
| 155 | + else { |
| 156 | + $targets = $egPushTargets; |
| 157 | + } |
| 158 | + |
| 159 | + $wgOut->addWikiMsg( 'push-special-pushing-desc', $wgLang->listToText( $links ), $wgLang->formatNum( count( $pages ) ) ); |
| 160 | + |
| 161 | + $wgOut->addHTML( |
| 162 | + Html::hidden( 'siteName', $wgSitename, array( 'id' => 'siteName' ) ) . |
| 163 | + Html::rawElement( |
| 164 | + 'div', |
| 165 | + array( |
| 166 | + 'id' => 'pushResultDiv', |
| 167 | + 'style' => 'width: 100%; height: 300px; overflow: auto' |
| 168 | + ), |
| 169 | + Html::rawElement( |
| 170 | + 'div', |
| 171 | + array( 'class' => 'innerResultBox' ), |
| 172 | + Html::element( 'ul', array( 'id' => 'pushResultList' ) ) |
| 173 | + ) |
| 174 | + ) |
| 175 | + ); |
| 176 | + |
| 177 | + $wgOut->addInlineScript( |
| 178 | + 'var wgPushPages = ' . json_encode( $pages ) . ';' . |
| 179 | + 'var wgPushTargets = ' . json_encode( $targets ) . ';' . |
| 180 | + 'var wgPushWorkerCount = ' . $egPushBulkWorkers . ';' . |
| 181 | + 'var wgPushBatchSize = ' . $egPushBatchSize . ';' |
| 182 | + ); |
| 183 | + |
| 184 | + $this->loadJs(); |
| 185 | + } |
| 186 | + |
| 187 | + /** |
| 188 | + * @since 0.2 |
| 189 | + */ |
| 190 | + protected function displayPushInterface( $arg, $pages ) { |
| 191 | + global $wgOut, $wgUser, $wgRequest, $egPushTargets; |
| 192 | + |
| 193 | + $wgOut->addWikiMsg( 'push-special-description' ); |
| 194 | + |
| 195 | + $form = Xml::openElement( 'form', array( 'method' => 'post', |
| 196 | + 'action' => $this->getTitle()->getLocalUrl( 'action=submit' ) ) ); |
| 197 | + $form .= Xml::inputLabel( wfMsg( 'export-addcattext' ) , 'catname', 'catname', 40 ) . ' '; |
| 198 | + $form .= Xml::submitButton( wfMsg( 'export-addcat' ), array( 'name' => 'addcat' ) ) . '<br />'; |
| 199 | + |
| 200 | + $form .= Xml::namespaceSelector( $wgRequest->getText( 'nsindex', '' ), null, 'nsindex', wfMsg( 'export-addnstext' ) ) . ' '; |
| 201 | + $form .= Xml::submitButton( wfMsg( 'export-addns' ), array( 'name' => 'addns' ) ) . '<br />'; |
| 202 | + |
| 203 | + $form .= Xml::element( 'textarea', array( 'name' => 'pages', 'cols' => 40, 'rows' => 10 ), $pages, false ); |
| 204 | + $form .= '<br />'; |
| 205 | + |
| 206 | + $form .= Xml::checkLabel( |
| 207 | + wfMsg( 'export-templates' ), |
| 208 | + 'templates', |
| 209 | + 'wpExportTemplates', |
| 210 | + $wgRequest->wasPosted() ? $wgRequest->getCheck( 'templates' ) : false |
| 211 | + ) . '<br />'; |
| 212 | + |
| 213 | + if ( count( $egPushTargets ) == 1 ) { |
| 214 | + $names = array_keys( $egPushTargets ); |
| 215 | + $form .= '<b>' . htmlspecialchars( wfMsgExt( 'push-special-target-is', 'parsemag', $names[0] ) ) . '</b><br />'; |
| 216 | + } |
| 217 | + else { |
| 218 | + $form .= '<b>' . htmlspecialchars( wfMsg( 'push-special-select-targets' ) ) . '</b><br />'; |
| 219 | + |
| 220 | + foreach ( $egPushTargets as $targetName => $targetUrl ) { |
| 221 | + $checkName = str_replace( ' ', '_', $targetName ); |
| 222 | + $checked = $wgRequest->wasPosted() ? $wgRequest->getCheck( $checkName ) : true; |
| 223 | + $form .= Xml::checkLabel( $targetName, $checkName, $targetName, $checked ) . '<br />'; |
| 224 | + } |
| 225 | + } |
| 226 | + |
| 227 | + $form .= Xml::submitButton( wfMsg( 'push-special-button-text' ), array( 'style' => 'width: 125px; height: 30px' ) ); |
| 228 | + $form .= Xml::closeElement( 'form' ); |
| 229 | + |
| 230 | + $wgOut->addHTML( $form ); |
| 231 | + } |
| 232 | + |
| 233 | + /** |
| 234 | + * Returns all pages for a category (up to 5000). |
| 235 | + * |
| 236 | + * @since 0.2 |
| 237 | + * |
| 238 | + * @param Title $title |
| 239 | + * |
| 240 | + * @return array |
| 241 | + */ |
| 242 | + protected function getPagesFromCategory( Title $title ) { |
| 243 | + global $wgContLang; |
| 244 | + |
| 245 | + $name = $title->getDBkey(); |
| 246 | + |
| 247 | + $dbr = wfGetDB( DB_SLAVE ); |
| 248 | + $res = $dbr->select( |
| 249 | + array( 'page', 'categorylinks' ), |
| 250 | + array( 'page_namespace', 'page_title' ), |
| 251 | + array( 'cl_from=page_id', 'cl_to' => $name ), |
| 252 | + __METHOD__, |
| 253 | + array( 'LIMIT' => '5000' ) |
| 254 | + ); |
| 255 | + |
| 256 | + $pages = array(); |
| 257 | + |
| 258 | + foreach ( $res as $row ) { |
| 259 | + $n = $row->page_title; |
| 260 | + if ($row->page_namespace) { |
| 261 | + $ns = $wgContLang->getNsText( $row->page_namespace ); |
| 262 | + $n = $ns . ':' . $n; |
| 263 | + } |
| 264 | + |
| 265 | + $pages[] = $n; |
| 266 | + } |
| 267 | + return $pages; |
| 268 | + } |
| 269 | + |
| 270 | + /** |
| 271 | + * Returns all pages for a namespace (up to 5000). |
| 272 | + * |
| 273 | + * @since 0.2 |
| 274 | + * |
| 275 | + * @param integer $nsindex |
| 276 | + * |
| 277 | + * @return array |
| 278 | + */ |
| 279 | + protected function getPagesFromNamespace( $nsindex ) { |
| 280 | + global $wgContLang; |
| 281 | + |
| 282 | + $dbr = wfGetDB( DB_SLAVE ); |
| 283 | + $res = $dbr->select( |
| 284 | + 'page', |
| 285 | + array( 'page_namespace', 'page_title' ), |
| 286 | + array( 'page_namespace' => $nsindex ), |
| 287 | + __METHOD__, |
| 288 | + array( 'LIMIT' => '5000' ) |
| 289 | + ); |
| 290 | + |
| 291 | + $pages = array(); |
| 292 | + |
| 293 | + foreach ( $res as $row ) { |
| 294 | + $n = $row->page_title; |
| 295 | + |
| 296 | + if ( $row->page_namespace ) { |
| 297 | + $ns = $wgContLang->getNsText( $row->page_namespace ); |
| 298 | + $n = $ns . ':' . $n; |
| 299 | + } |
| 300 | + |
| 301 | + $pages[] = $n; |
| 302 | + } |
| 303 | + return $pages; |
| 304 | + } |
| 305 | + |
| 306 | + /** |
| 307 | + * Expand a list of pages to include templates used in those pages. |
| 308 | + * |
| 309 | + * @since 0.2 |
| 310 | + * |
| 311 | + * @param $inputPages array list of titles to look up |
| 312 | + * @param $pageSet array associative array indexed by titles for output |
| 313 | + * |
| 314 | + * @return array associative array index by titles |
| 315 | + */ |
| 316 | + private function getTemplates( $inputPages, $pageSet ) { |
| 317 | + return $this->getLinks( $inputPages, $pageSet, |
| 318 | + 'templatelinks', |
| 319 | + array( 'tl_namespace AS namespace', 'tl_title AS title' ), |
| 320 | + array( 'page_id=tl_from' ) |
| 321 | + ); |
| 322 | + } |
| 323 | + |
| 324 | + /** |
| 325 | + * Expand a list of pages to include items used in those pages. |
| 326 | + * |
| 327 | + * @since 0.2 |
| 328 | + */ |
| 329 | + protected function getLinks( $inputPages, $pageSet, $table, $fields, $join ) { |
| 330 | + $dbr = wfGetDB( DB_SLAVE ); |
| 331 | + |
| 332 | + foreach( $inputPages as $page ) { |
| 333 | + $title = Title::newFromText( $page ); |
| 334 | + |
| 335 | + if( $title ) { |
| 336 | + $pageSet[$title->getPrefixedText()] = true; |
| 337 | + /// @todo Fixme: May or may not be more efficient to batch these |
| 338 | + /// by namespace when given multiple input pages. |
| 339 | + $result = $dbr->select( |
| 340 | + array( 'page', $table ), |
| 341 | + $fields, |
| 342 | + array_merge( |
| 343 | + $join, |
| 344 | + array( |
| 345 | + 'page_namespace' => $title->getNamespace(), |
| 346 | + 'page_title' => $title->getDBkey() |
| 347 | + ) |
| 348 | + ), |
| 349 | + __METHOD__ |
| 350 | + ); |
| 351 | + |
| 352 | + foreach( $result as $row ) { |
| 353 | + $template = Title::makeTitle( $row->namespace, $row->title ); |
| 354 | + $pageSet[$template->getPrefixedText()] = true; |
| 355 | + } |
| 356 | + } |
| 357 | + } |
| 358 | + |
| 359 | + return $pageSet; |
| 360 | + } |
| 361 | + |
| 362 | + /** |
| 363 | + * Loads the needed JavaScript. |
| 364 | + * Takes care of non-RL compatibility. |
| 365 | + * |
| 366 | + * @since 0.2 |
| 367 | + */ |
| 368 | + protected static function loadJs() { |
| 369 | + global $wgOut; |
| 370 | + |
| 371 | + // For backward compatibility with MW < 1.17. |
| 372 | + if ( is_callable( array( $wgOut, 'addModules' ) ) ) { |
| 373 | + $wgOut->addModules( 'ext.push.special' ); |
| 374 | + } |
| 375 | + else { |
| 376 | + global $egPushScriptPath; |
| 377 | + |
| 378 | + PushFunctions::addJSLocalisation(); |
| 379 | + |
| 380 | + $wgOut->includeJQuery(); |
| 381 | + |
| 382 | + $wgOut->addHeadItem( |
| 383 | + 'ext.push.special', |
| 384 | + Html::linkedScript( $egPushScriptPath . '/specials/ext.push.special.js' ) |
| 385 | + ); |
| 386 | + } |
| 387 | + } |
| 388 | + |
| 389 | +} |
\ No newline at end of file |
Property changes on: tags/extensions/Push/REL_0_3/specials/Push_Body.php |
___________________________________________________________________ |
Added: svn:eol-style |
1 | 390 | + native |
Index: tags/extensions/Push/REL_0_3/specials/ext.push.special.js |
— | — | @@ -0,0 +1,110 @@ |
| 2 | +/** |
| 3 | + * JavasSript for Special:Push in the Push extension. |
| 4 | + * @see http://www.mediawiki.org/wiki/Extension:Push |
| 5 | + * |
| 6 | + * @author Jeroen De Dauw <jeroendedauw at gmail dot com> |
| 7 | + */ |
| 8 | + |
| 9 | +(function($) { $( document ).ready( function() { |
| 10 | + |
| 11 | + // Compatibility with pre-RL code. |
| 12 | + // Messages will have been loaded into wgPushMessages. |
| 13 | + if ( typeof mediaWiki === 'undefined' ) { |
| 14 | + mediaWiki = new Object(); |
| 15 | + |
| 16 | + mediaWiki.msg = function() { |
| 17 | + message = window.wgPushMessages[arguments[0]]; |
| 18 | + |
| 19 | + for ( var i = arguments.length - 1; i > 0; i-- ) { |
| 20 | + message = message.replace( '$' + i, arguments[i] ); |
| 21 | + } |
| 22 | + |
| 23 | + return message; |
| 24 | + } |
| 25 | + } |
| 26 | + |
| 27 | + var resultList = $('#pushResultList'); |
| 28 | + |
| 29 | + var targets = []; |
| 30 | + for (targetName in window.wgPushTargets) targets.push( window.wgPushTargets[targetName] ); |
| 31 | + |
| 32 | + var pages = window.wgPushPages; |
| 33 | + |
| 34 | + var requestAmount = Math.min( pages.length, window.wgPushWorkerCount ); |
| 35 | + var batchSize = Math.min( targets.length, window.wgPushBatchSize ); |
| 36 | + |
| 37 | + for ( i = requestAmount; i > 0; i-- ) { |
| 38 | + initiateNextPush(); |
| 39 | + } |
| 40 | + |
| 41 | + function initiateNextPush() { |
| 42 | + var page = pages.pop(); |
| 43 | + |
| 44 | + if ( page ) { |
| 45 | + startPush( page, 0, null ); |
| 46 | + } |
| 47 | + else if ( !--requestAmount ) { |
| 48 | + showCompletion(); |
| 49 | + } |
| 50 | + } |
| 51 | + |
| 52 | + function startPush( pageName, targetOffset, listItem ) { |
| 53 | + if ( targetOffset == 0 ) { |
| 54 | + var listItem = $( '<li />' ); |
| 55 | + listItem.text( mediaWiki.msg( 'push-special-item-pushing', pageName ) ); |
| 56 | + |
| 57 | + var box = $('#pushResultDiv'); |
| 58 | + var innerBox = $('#pushResultDiv > .innerResultBox'); |
| 59 | + var atBottom = Math.abs(innerBox.offset().top) + box.height() + box.offset().top >= innerBox.outerHeight(); |
| 60 | + |
| 61 | + resultList.append( listItem ); |
| 62 | + |
| 63 | + if ( atBottom ) { |
| 64 | + box.attr( {'scrollTop': box.attr( 'scrollHeight' )} ); |
| 65 | + } |
| 66 | + } |
| 67 | + |
| 68 | + var currentBatchLimit = Math.min( targetOffset + batchSize, targets.length ); |
| 69 | + var currentBatchStart = targetOffset; |
| 70 | + |
| 71 | + if ( targetOffset < targets.length ) { |
| 72 | + listItem.text( listItem.text() + '...' ); |
| 73 | + |
| 74 | + targetOffset = currentBatchLimit; |
| 75 | + |
| 76 | + $.getJSON( |
| 77 | + wgScriptPath + '/api.php', |
| 78 | + { |
| 79 | + 'action': 'push', |
| 80 | + 'format': 'json', |
| 81 | + 'page': pageName, |
| 82 | + 'targets': targets.slice( currentBatchStart, currentBatchLimit ).join( '|' ) |
| 83 | + }, |
| 84 | + function( data ) { |
| 85 | + if ( data.error ) { |
| 86 | + handleError( listItem, pageName, data.error ); |
| 87 | + } |
| 88 | + else { |
| 89 | + startPush( pageName, targetOffset, listItem ); |
| 90 | + } |
| 91 | + } |
| 92 | + ); |
| 93 | + } |
| 94 | + else { |
| 95 | + listItem.text( mediaWiki.msg( 'push-special-item-completed', pageName ) ); |
| 96 | + listItem.css( 'color', 'darkgray' ); |
| 97 | + initiateNextPush(); |
| 98 | + } |
| 99 | + } |
| 100 | + |
| 101 | + function showCompletion() { |
| 102 | + resultList.append( $( '<li />' ).append( $( '<b />' ).text( mediaWiki.msg( 'push-special-push-done' ) ) ) ); |
| 103 | + } |
| 104 | + |
| 105 | + function handleError( listItem, pageName, error ) { |
| 106 | + listItem.text( mediaWiki.msg( 'push-special-item-failed', pageName, error.info ) ); |
| 107 | + listItem.css( 'color', 'darkred' ); |
| 108 | + initiateNextPush(); |
| 109 | + } |
| 110 | + |
| 111 | +} ); })(jQuery); |
\ No newline at end of file |
Property changes on: tags/extensions/Push/REL_0_3/specials/ext.push.special.js |
___________________________________________________________________ |
Added: svn:eol-style |
1 | 112 | + native |
Index: tags/extensions/Push/REL_0_3/Push.php |
— | — | @@ -0,0 +1,102 @@ |
| 2 | +<?php |
| 3 | + |
| 4 | +/** |
| 5 | + * Initialization file for the Push extension. |
| 6 | + * |
| 7 | + * On MediaWiki.org: http://www.mediawiki.org/wiki/Extension:Push |
| 8 | + * Source code: http://svn.wikimedia.org/viewvc/mediawiki/trunk/extensions/Push |
| 9 | + * |
| 10 | + * @file Push.php |
| 11 | + * @ingroup Push |
| 12 | + * |
| 13 | + * @author Jeroen De Dauw < jeroendedauw@gmail.com > |
| 14 | + */ |
| 15 | + |
| 16 | +/** |
| 17 | + * This documenation group collects source code files belonging to Push. |
| 18 | + * |
| 19 | + * @defgroup Push Push |
| 20 | + */ |
| 21 | + |
| 22 | +if ( !defined( 'MEDIAWIKI' ) ) { |
| 23 | + die( 'Not an entry point.' ); |
| 24 | +} |
| 25 | + |
| 26 | +define( 'Push_VERSION', '0.3' ); |
| 27 | + |
| 28 | +$wgExtensionCredits['other'][] = array( |
| 29 | + 'path' => __FILE__, |
| 30 | + 'name' => 'Push', |
| 31 | + 'version' => Push_VERSION, |
| 32 | + 'author' => array( |
| 33 | + '[http://www.mediawiki.org/wiki/User:Jeroen_De_Dauw Jeroen De Dauw] for [http://www.wikiworks.com WikiWorks]', |
| 34 | + ), |
| 35 | + 'url' => 'http://www.mediawiki.org/wiki/Extension:Push', |
| 36 | + 'descriptionmsg' => 'push-desc' |
| 37 | +); |
| 38 | + |
| 39 | +$useExtensionPath = version_compare( $wgVersion, '1.16', '>=' ) && isset( $wgExtensionAssetsPath ) && $wgExtensionAssetsPath; |
| 40 | +$egPushScriptPath = ( $useExtensionPath ? $wgExtensionAssetsPath : $wgScriptPath . '/extensions' ) . '/Push'; |
| 41 | +$egPushIP = dirname( __FILE__ ); |
| 42 | +unset( $useExtensionPath ); |
| 43 | + |
| 44 | +$wgExtensionMessagesFiles['Push'] = $egPushIP . '/Push.i18n.php'; |
| 45 | +$wgExtensionAliasesFiles['Push'] = $egPushIP . '/Push.alias.php'; |
| 46 | + |
| 47 | +$wgAutoloadClasses['PushHooks'] = $egPushIP . '/Push.hooks.php'; |
| 48 | +$wgAutoloadClasses['ApiPush'] = $egPushIP . '/api/ApiPush.php'; |
| 49 | +$wgAutoloadClasses['PushTab'] = $egPushIP . '/includes/Push_Tab.php'; |
| 50 | +$wgAutoloadClasses['PushFunctions'] = $egPushIP . '/includes/Push_Functions.php'; |
| 51 | +$wgAutoloadClasses['SpecialPush'] = $egPushIP . '/specials/Push_Body.php'; |
| 52 | + |
| 53 | +$wgSpecialPages['Push'] = 'SpecialPush'; |
| 54 | +$wgSpecialPageGroups['Push'] = 'pagetools'; |
| 55 | + |
| 56 | +$wgAPIModules['push'] = 'ApiPush'; |
| 57 | + |
| 58 | +$wgHooks['UnknownAction'][] = 'PushTab::onUnknownAction'; |
| 59 | +$wgHooks['SkinTemplateTabs'][] = 'PushTab::displayTab'; |
| 60 | +$wgHooks['SkinTemplateNavigation'][] = 'PushTab::displayTab2'; |
| 61 | + |
| 62 | +$wgHooks['AdminLinks'][] = 'PushHooks::addToAdminLinks'; |
| 63 | + |
| 64 | +$wgAvailableRights[] = 'push'; |
| 65 | +$wgAvailableRights[] = 'pushadmin'; |
| 66 | + |
| 67 | +$egPushJSMessages = array( |
| 68 | + 'push-button-pushing', |
| 69 | + 'push-button-completed', |
| 70 | + 'push-button-failed', |
| 71 | + 'push-import-revision-message', |
| 72 | + 'push-import-revision-comment', |
| 73 | + 'push-button-text', |
| 74 | + 'push-button-all', |
| 75 | + 'push-special-item-pushing', |
| 76 | + 'push-special-item-completed', |
| 77 | + 'push-special-item-failed', |
| 78 | + 'push-special-push-done', |
| 79 | + 'push-err-captacha', |
| 80 | +); |
| 81 | + |
| 82 | +// For backward compatibility with MW < 1.17. |
| 83 | +if ( is_callable( array( 'OutputPage', 'addModules' ) ) ) { |
| 84 | + $moduleTemplate = array( |
| 85 | + 'localBasePath' => dirname( __FILE__ ), |
| 86 | + 'remoteBasePath' => $egPushScriptPath, |
| 87 | + 'group' => 'ext.push' |
| 88 | + ); |
| 89 | + |
| 90 | + $wgResourceModules['ext.push.tab'] = $moduleTemplate + array( |
| 91 | + 'scripts' => 'includes/ext.push.tab.js', |
| 92 | + 'dependencies' => array(), |
| 93 | + 'messages' => $egPushJSMessages |
| 94 | + ); |
| 95 | + |
| 96 | + $wgResourceModules['ext.push.special'] = $moduleTemplate + array( |
| 97 | + 'scripts' => 'specials/ext.push.special.js', |
| 98 | + 'dependencies' => array(), |
| 99 | + 'messages' => $egPushJSMessages |
| 100 | + ); |
| 101 | +} |
| 102 | + |
| 103 | +require_once 'Push_Settings.php'; |
Property changes on: tags/extensions/Push/REL_0_3/Push.php |
___________________________________________________________________ |
Added: svn:eol-style |
1 | 104 | + native |
Index: tags/extensions/Push/REL_0_3/Push_Settings.php |
— | — | @@ -0,0 +1,31 @@ |
| 2 | +<?php |
| 3 | + |
| 4 | +/** |
| 5 | + * File defining the settings for the Push extension. |
| 6 | + * More info can be found at http://www.mediawiki.org/wiki/Extension:Push#Settings |
| 7 | + * |
| 8 | + * NOTICE: |
| 9 | + * Changing one of these settings can be done by copieng or cutting it, |
| 10 | + * and placing it in LocalSettings.php, AFTER the inclusion of Push. |
| 11 | + * |
| 12 | + * @file Push_Settings.php |
| 13 | + * @ingroup Push |
| 14 | + * |
| 15 | + * @author Jeroen De Dauw < jeroendedauw@gmail.com > |
| 16 | + */ |
| 17 | + |
| 18 | +if ( !defined( 'MEDIAWIKI' ) ) { |
| 19 | + die( 'Not an entry point.' ); |
| 20 | +} |
| 21 | + |
| 22 | +$egPushTargets = array(); |
| 23 | + |
| 24 | +$wgGroupPermissions['*']['push'] = true; |
| 25 | +$wgGroupPermissions['autoconfirmed']['bulkpush'] = true; |
| 26 | +$wgGroupPermissions['sysop']['bulkpush'] = true; |
| 27 | +$wgGroupPermissions['sysop']['pushadmin'] = true; |
| 28 | + |
| 29 | +$egPushShowTab = false; |
| 30 | + |
| 31 | +$egPushBulkWorkers = 3; |
| 32 | +$egPushBatchSize = 3; |
Property changes on: tags/extensions/Push/REL_0_3/Push_Settings.php |
___________________________________________________________________ |
Added: svn:eol-style |
1 | 33 | + native |
Index: tags/extensions/Push/REL_0_3/INSTALL |
— | — | @@ -0,0 +1,30 @@ |
| 2 | +These is the install file for the Push extension. |
| 3 | + |
| 4 | +Extension page on mediawiki.org: http://www.mediawiki.org/wiki/Extension:Push |
| 5 | +Latest version of the install file: http://svn.wikimedia.org/viewvc/mediawiki/trunk/extensions/Push/INSTALL?view=co |
| 6 | + |
| 7 | + |
| 8 | +== Installation == |
| 9 | + |
| 10 | +Once you have downloaded the code, place the ''Push'' directory within your MediaWiki 'extensions' directory. |
| 11 | +Then add the following code to your [[Manual:LocalSettings.php|LocalSettings.php]] file: |
| 12 | + |
| 13 | +# Push |
| 14 | +require_once( "$IP/extensions/Push/Push.php" ); |
| 15 | + |
| 16 | +== Configuration == |
| 17 | + |
| 18 | +=== Push targets === |
| 19 | + |
| 20 | +You can add push targets (wikis you can push content to) by adding elements to the $egPushTarget array in your |
| 21 | +[[Manual:LocalSettings.php|LocalSettings.php]] file. The array keys should be the names of your wikis and the |
| 22 | +values should point to the wiki root, without tailing slash. Example: |
| 23 | + |
| 24 | +$egPushTargets['Local MW 1.16'] = 'http://localhost/mw116'; |
| 25 | +$egPushTargets['Local MW trunk'] = 'http://localhost/phase3'; |
| 26 | + |
| 27 | +=== Tab display === |
| 28 | + |
| 29 | +When using vector like skins, you can choose to have the push tab displayed on the page itself, or in the action |
| 30 | +menu you can open by clicking the down arrow next to the visible tabs. For this you need to set the $egPushShowTab |
| 31 | + variable to either true or false in your [[Manual:LocalSettings.php|LocalSettings.php]] file. |
\ No newline at end of file |
Index: tags/extensions/Push/REL_0_3/RELEASE-NOTES |
— | — | @@ -0,0 +1,29 @@ |
| 2 | +These are the release notes for the Push extension. |
| 3 | + |
| 4 | +Extension page on mediawiki.org: http://www.mediawiki.org/wiki/Extension:Push |
| 5 | +Latest version of the release notes: http://svn.wikimedia.org/viewvc/mediawiki/trunk/extensions/Push/RELEASE-NOTES?view=co |
| 6 | + |
| 7 | + |
| 8 | +=== Version 0.3 === |
| 9 | +2010-12-10 |
| 10 | + |
| 11 | +* Fixed push functionality for wikis on remote domains. |
| 12 | +* Added 'bulkpush' right. |
| 13 | +* Added batch operations to Special:Push. |
| 14 | +* Added redlink support to the tab interface. |
| 15 | +* Improved error handling. |
| 16 | + |
| 17 | +=== Version 0.2 === |
| 18 | +2010-12-08 |
| 19 | + |
| 20 | +* Added Special:Push for bulk pushing |
| 21 | +* Added AdminLinks hook |
| 22 | + |
| 23 | +=== Version 0.1 === |
| 24 | +2010-12-08 |
| 25 | + |
| 26 | +Initial release. |
| 27 | + |
| 28 | +* Added push tab that allows pushing the page to one or more other wikis |
| 29 | +* Added ApprovedRevs support |
| 30 | +* Added 'push' right |
\ No newline at end of file |
Index: tags/extensions/Push/REL_0_3/includes/Push_Tab.php |
— | — | @@ -0,0 +1,315 @@ |
| 2 | +<?php |
| 3 | + |
| 4 | +/** |
| 5 | + * Statis class with methods to create and handle the push tab. |
| 6 | + * |
| 7 | + * @since 0.1 |
| 8 | + * |
| 9 | + * @file Push_Tab.php |
| 10 | + * @ingroup Push |
| 11 | + * |
| 12 | + * @author Jeroen De Dauw < jeroendedauw@gmail.com > |
| 13 | + */ |
| 14 | +final class PushTab { |
| 15 | + |
| 16 | + /** |
| 17 | + * Adds an "action" (i.e., a tab) to allow pushing the current article. |
| 18 | + */ |
| 19 | + public static function displayTab( $obj, &$content_actions ) { |
| 20 | + global $wgUser, $egPushTargets; |
| 21 | + |
| 22 | + // Make sure that this is not a special page, the page has contents, and the user can push. |
| 23 | + if (isset( $obj->mTitle ) |
| 24 | + && $obj->mTitle->getNamespace() != NS_SPECIAL |
| 25 | + && $obj->mTitle->exists() |
| 26 | + && $wgUser->isAllowed( 'push' ) |
| 27 | + && count( $egPushTargets ) > 0 ) { |
| 28 | + |
| 29 | + global $wgRequest; |
| 30 | + |
| 31 | + $content_actions['push'] = array( |
| 32 | + 'text' => wfMsg( 'push-tab-text' ), |
| 33 | + 'class' => $wgRequest->getVal( 'action' ) == 'push' ? 'selected' : '', |
| 34 | + 'href' => $obj->mTitle->getLocalURL( 'action=push' ) |
| 35 | + ); |
| 36 | + } |
| 37 | + |
| 38 | + return true; |
| 39 | + } |
| 40 | + |
| 41 | + /** |
| 42 | + * Function currently called only for the 'Vector' skin, added in |
| 43 | + * MW 1.16 - will possibly be called for additional skins later |
| 44 | + */ |
| 45 | + public static function displayTab2( $obj, &$links ) { |
| 46 | + global $egPushShowTab; |
| 47 | + |
| 48 | + // The old '$content_actions' array is thankfully just a sub-array of this one |
| 49 | + $views_links = $links[$egPushShowTab ? 'views' : 'actions']; |
| 50 | + self::displayTab( $obj, $views_links ); |
| 51 | + $links[$egPushShowTab ? 'views' : 'actions'] = $views_links; |
| 52 | + |
| 53 | + return true; |
| 54 | + } |
| 55 | + |
| 56 | + /** |
| 57 | + * Handle actions not known to MediaWiki. If the action is push, |
| 58 | + * display the push page by calling the displayPushPage method. |
| 59 | + * |
| 60 | + * @param string $action |
| 61 | + * @param Article $article |
| 62 | + * |
| 63 | + * @return true |
| 64 | + */ |
| 65 | + public static function onUnknownAction( $action, Article $article ) { |
| 66 | + if ( $action == 'push' ) { |
| 67 | + return self::displayPushPage( $article ); |
| 68 | + } |
| 69 | + else { |
| 70 | + return true; |
| 71 | + } |
| 72 | + } |
| 73 | + |
| 74 | + /** |
| 75 | + * Loads the needed JavaScript. |
| 76 | + * Takes care of non-RL compatibility. |
| 77 | + * |
| 78 | + * @since 0.1 |
| 79 | + */ |
| 80 | + protected static function loadJs() { |
| 81 | + global $wgOut; |
| 82 | + |
| 83 | + // For backward compatibility with MW < 1.17. |
| 84 | + if ( is_callable( array( $wgOut, 'addModules' ) ) ) { |
| 85 | + $wgOut->addModules( 'ext.push.tab' ); |
| 86 | + } |
| 87 | + else { |
| 88 | + global $egPushScriptPath; |
| 89 | + |
| 90 | + PushFunctions::addJSLocalisation(); |
| 91 | + |
| 92 | + $wgOut->includeJQuery(); |
| 93 | + |
| 94 | + $wgOut->addHeadItem( |
| 95 | + 'ext.push.tab', |
| 96 | + Html::linkedScript( $egPushScriptPath . '/includes/ext.push.tab.js' ) |
| 97 | + ); |
| 98 | + } |
| 99 | + } |
| 100 | + |
| 101 | + /** |
| 102 | + * The function called if we're in index.php (as opposed to one of the |
| 103 | + * special pages) |
| 104 | + * |
| 105 | + * @since 0.1 |
| 106 | + */ |
| 107 | + public static function displayPushPage( Article $article ) { |
| 108 | + global $wgOut, $wgUser, $wgTitle, $wgSitename, $egPushTargets; |
| 109 | + |
| 110 | + $wgOut->setPageTitle( wfMsgExt( 'push-tab-title', 'parsemag', $article->getTitle()->getText() ) ); |
| 111 | + |
| 112 | + if ( !$wgUser->isAllowed( 'push' ) ) { |
| 113 | + $wgOut->permissionRequired( 'push' ); |
| 114 | + return false; |
| 115 | + } |
| 116 | + |
| 117 | + $wgOut->addHTML( '<p>' . htmlspecialchars( wfMsg( 'push-tab-desc' ) ) . '</p>' ); |
| 118 | + |
| 119 | + if ( count( $egPushTargets ) == 0 ) { |
| 120 | + $wgOut->addHTML( '<p>' . htmlspecialchars( wfMsg( 'push-tab-no-targets' ) ) . '</p>' ); |
| 121 | + return false; |
| 122 | + } |
| 123 | + |
| 124 | + self::loadJs(); |
| 125 | + |
| 126 | + $wgOut->addHTML( |
| 127 | + Html::hidden( 'pageName', $wgTitle->getFullText(), array( 'id' => 'pageName' ) ) . |
| 128 | + Html::hidden( 'siteName', $wgSitename, array( 'id' => 'siteName' ) ) |
| 129 | + ); |
| 130 | + |
| 131 | + if ( count( $egPushTargets ) == 1 ) { |
| 132 | + self::displayLonelyPushItem(); |
| 133 | + } |
| 134 | + else { |
| 135 | + self::displayPushList(); |
| 136 | + } |
| 137 | + |
| 138 | + if ( $wgUser->isAllowed( 'pushadmin' ) ) { |
| 139 | + // TODO |
| 140 | + //self::displayNewPushItem(); |
| 141 | + } |
| 142 | + |
| 143 | + return false; |
| 144 | + } |
| 145 | + |
| 146 | + /** |
| 147 | + * Displays a target to push to for when there is only a single target. |
| 148 | + * |
| 149 | + * @since 0.1 |
| 150 | + */ |
| 151 | + protected static function displayLonelyPushItem() { |
| 152 | + global $wgOut, $wgTitle, $egPushTargets; |
| 153 | + |
| 154 | + $targetNames = array_keys( $egPushTargets ); |
| 155 | + |
| 156 | + $wgOut->addHTML( |
| 157 | + '<table><tr><td><b>' . htmlspecialchars( wfMsgExt( 'push-tab-push-to', 'parsemag', $targetNames[0] ) ) . '</b><br /><i>' . |
| 158 | + Html::element( |
| 159 | + 'a', |
| 160 | + array( 'href' => $egPushTargets[$targetNames[0]] . '/index.php?title=' . $wgTitle->getFullText(), 'rel' => 'nofollow' ), |
| 161 | + wfMsgExt( 'push-remote-page-link-full', 'parsemag', $wgTitle->getFullText(), $targetNames[0] ) |
| 162 | + ) . '</i></td><td>   ' . |
| 163 | + Html::element( |
| 164 | + 'button', |
| 165 | + array( |
| 166 | + 'class' => 'push-button', |
| 167 | + 'pushtarget' => $egPushTargets[$targetNames[0]], |
| 168 | + 'style' => 'width: 125px; height: 30px', |
| 169 | + ), |
| 170 | + wfMsg( 'push-button-text' ) |
| 171 | + ) . '</td></tr></table>' |
| 172 | + ); |
| 173 | + } |
| 174 | + |
| 175 | + /** |
| 176 | + * Displays a list with all targets to which can be pushed. |
| 177 | + * |
| 178 | + * @since 0.1 |
| 179 | + */ |
| 180 | + protected static function displayPushList() { |
| 181 | + global $wgOut, $egPushTargets, $wgLang; |
| 182 | + |
| 183 | + $items = array( |
| 184 | + Html::rawElement( |
| 185 | + 'tr', |
| 186 | + array(), |
| 187 | + Html::element( |
| 188 | + 'th', |
| 189 | + array(), |
| 190 | + wfMsg( 'push-targets' ) |
| 191 | + ) . |
| 192 | + Html::element( |
| 193 | + 'th', |
| 194 | + array(), |
| 195 | + wfMsg( 'push-remote-pages' ) |
| 196 | + ) . |
| 197 | + Html::element( |
| 198 | + 'th', |
| 199 | + array( 'width' => '125px' ), |
| 200 | + '' |
| 201 | + ) |
| 202 | + ) |
| 203 | + ); |
| 204 | + |
| 205 | + foreach ( $egPushTargets as $name => $url ) { |
| 206 | + $items[] = self::getPushItem( $name, $url ); |
| 207 | + } |
| 208 | + |
| 209 | + $items[] = Html::rawElement( |
| 210 | + 'tr', |
| 211 | + array(), |
| 212 | + Html::element( |
| 213 | + 'th', |
| 214 | + array( 'colspan' => 2, 'style' => 'text-align: left' ), |
| 215 | + wfMsgExt( 'push-targets-total', 'parsemag', $wgLang->formatNum( count( $egPushTargets ) ) ) |
| 216 | + ) . |
| 217 | + Html::rawElement( |
| 218 | + 'th', |
| 219 | + array( 'width' => '125px' ), |
| 220 | + Html::element( |
| 221 | + 'button', |
| 222 | + array( |
| 223 | + 'id' => 'push-all-button', |
| 224 | + 'style' => 'width: 125px; height: 30px', |
| 225 | + ), |
| 226 | + wfMsg( 'push-button-all' ) |
| 227 | + ) |
| 228 | + ) |
| 229 | + ); |
| 230 | + |
| 231 | + $wgOut->addHtml( |
| 232 | + Html::rawElement( |
| 233 | + 'table', |
| 234 | + array( 'class' => 'wikitable', 'width' => '50%' ), |
| 235 | + implode( "\n", $items ) |
| 236 | + ) |
| 237 | + ); |
| 238 | + } |
| 239 | + |
| 240 | + /** |
| 241 | + * Returns the HTML for a single push target. |
| 242 | + * |
| 243 | + * @since 0.1 |
| 244 | + * |
| 245 | + * @param string $name |
| 246 | + * @param string $url |
| 247 | + * |
| 248 | + * @return string |
| 249 | + */ |
| 250 | + protected static function getPushItem( $name, $url ) { |
| 251 | + global $wgTitle; |
| 252 | + |
| 253 | + static $targetId = 0; |
| 254 | + $targetId++; |
| 255 | + |
| 256 | + return Html::rawElement( |
| 257 | + 'tr', |
| 258 | + array(), |
| 259 | + Html::element( |
| 260 | + 'td', |
| 261 | + array(), |
| 262 | + $name |
| 263 | + ) . |
| 264 | + Html::rawElement( |
| 265 | + 'td', |
| 266 | + array(), |
| 267 | + Html::element( |
| 268 | + 'a', |
| 269 | + array( |
| 270 | + 'href' => $url . '/index.php?title=' . $wgTitle->getFullText(), |
| 271 | + 'rel' => 'nofollow', |
| 272 | + 'id' => 'targetlink' . $targetId |
| 273 | + ), |
| 274 | + wfMsgExt( 'push-remote-page-link', 'parsemag', $wgTitle->getFullText(), $name ) |
| 275 | + ) |
| 276 | + ) . |
| 277 | + Html::rawElement( |
| 278 | + 'td', |
| 279 | + array(), |
| 280 | + Html::element( |
| 281 | + 'button', |
| 282 | + array( |
| 283 | + 'class' => 'push-button', |
| 284 | + 'pushtarget' => $url, |
| 285 | + 'style' => 'width: 125px; height: 30px', |
| 286 | + 'targetid' => $targetId, |
| 287 | + 'targetname' => $name |
| 288 | + ), |
| 289 | + wfMsg( 'push-button-text' ) |
| 290 | + ) |
| 291 | + ) |
| 292 | + ); |
| 293 | + |
| 294 | + // TODO: add edit and delete stuff |
| 295 | + } |
| 296 | + |
| 297 | + /** |
| 298 | + * Displays a form via which a new push item can be added. |
| 299 | + * |
| 300 | + * @since 0.1 |
| 301 | + */ |
| 302 | + protected static function displayNewPushItem() { |
| 303 | + global $wgOut; |
| 304 | + |
| 305 | + $wgOut->addHtml( |
| 306 | + Html::element( |
| 307 | + 'h2', |
| 308 | + array(), |
| 309 | + wfMsg( 'push-add-target' ) |
| 310 | + ) |
| 311 | + ); |
| 312 | + |
| 313 | + // TODO |
| 314 | + } |
| 315 | + |
| 316 | +} |
\ No newline at end of file |
Property changes on: tags/extensions/Push/REL_0_3/includes/Push_Tab.php |
___________________________________________________________________ |
Added: svn:eol-style |
1 | 317 | + native |
Index: tags/extensions/Push/REL_0_3/includes/Push_Functions.php |
— | — | @@ -0,0 +1,48 @@ |
| 2 | +<?php |
| 3 | + |
| 4 | +/** |
| 5 | + * Statis class with utility methods for the Push extension. |
| 6 | + * |
| 7 | + * @since 0.2 |
| 8 | + * |
| 9 | + * @file Push_Functions.php |
| 10 | + * @ingroup Push |
| 11 | + * |
| 12 | + * @author Jeroen De Dauw < jeroendedauw@gmail.com > |
| 13 | + */ |
| 14 | +final class PushFunctions { |
| 15 | + |
| 16 | + public static function addJSLocalisation() { |
| 17 | + global $egPushJSMessages, $wgOut; |
| 18 | + |
| 19 | + $data = array(); |
| 20 | + |
| 21 | + foreach ( $egPushJSMessages as $msg ) { |
| 22 | + $data[$msg] = wfMsgNoTrans( $msg ); |
| 23 | + } |
| 24 | + |
| 25 | + $wgOut->addInlineScript( 'var wgPushMessages = ' . json_encode( $data ) . ';' ); |
| 26 | + } |
| 27 | + |
| 28 | + /** |
| 29 | + * Returns the latest revision. |
| 30 | + * Has support for the Approvedrevs extension, and will |
| 31 | + * return the latest approved revision where appropriate. |
| 32 | + * |
| 33 | + * @since 0.2 |
| 34 | + * |
| 35 | + * @param Title $title |
| 36 | + * |
| 37 | + * @return integer |
| 38 | + */ |
| 39 | + public static function getRevisionToPush( Title $title ) { |
| 40 | + if ( defined( 'APPROVED_REVS_VERSION' ) ) { |
| 41 | + $revId = ApprovedRevs::getApprovedRevID( $title ); |
| 42 | + return $revId ? $revId : $title->getLatestRevID(); |
| 43 | + } |
| 44 | + else { |
| 45 | + return $title->getLatestRevID(); |
| 46 | + } |
| 47 | + } |
| 48 | + |
| 49 | +} |
\ No newline at end of file |
Property changes on: tags/extensions/Push/REL_0_3/includes/Push_Functions.php |
___________________________________________________________________ |
Added: svn:eol-style |
1 | 50 | + native |
Index: tags/extensions/Push/REL_0_3/includes/ext.push.tab.js |
— | — | @@ -0,0 +1,125 @@ |
| 2 | +/** |
| 3 | + * JavasSript for the Push tab in the Push extension. |
| 4 | + * @see http://www.mediawiki.org/wiki/Extension:Push |
| 5 | + * |
| 6 | + * @author Jeroen De Dauw <jeroendedauw at gmail dot com> |
| 7 | + */ |
| 8 | + |
| 9 | +(function($) { $( document ).ready( function() { |
| 10 | + |
| 11 | + // Compatibility with pre-RL code. |
| 12 | + // Messages will have been loaded into wgPushMessages. |
| 13 | + if ( typeof mediaWiki === 'undefined' ) { |
| 14 | + mediaWiki = new Object(); |
| 15 | + |
| 16 | + mediaWiki.msg = function() { |
| 17 | + message = window.wgPushMessages[arguments[0]]; |
| 18 | + |
| 19 | + for ( var i = arguments.length - 1; i > 0; i-- ) { |
| 20 | + message = message.replace( '$' + i, arguments[i] ); |
| 21 | + } |
| 22 | + |
| 23 | + return message; |
| 24 | + } |
| 25 | + } |
| 26 | + |
| 27 | + $.each($(".push-button"), function(i,v) { |
| 28 | + getRemoteArticleInfo( $(v).attr( 'targetid' ), $(v).attr( 'pushtarget' ) ); |
| 29 | + }); |
| 30 | + |
| 31 | + $('.push-button').click(function() { |
| 32 | + this.disabled = true; |
| 33 | + this.innerHTML = mediaWiki.msg( 'push-button-pushing' ); |
| 34 | + |
| 35 | + initiatePush( |
| 36 | + this, |
| 37 | + $('#pageName').attr('value'), |
| 38 | + $(this).attr( 'pushtarget' ), |
| 39 | + $(this).attr( 'targetname' ) |
| 40 | + ); |
| 41 | + }); |
| 42 | + |
| 43 | + $('#push-all-button').click(function() { |
| 44 | + this.disabled = true; |
| 45 | + this.innerHTML = mediaWiki.msg( 'push-button-pushing' ); |
| 46 | + $.each($(".push-button"), function(i,v) { |
| 47 | + $(v).click(); |
| 48 | + }); |
| 49 | + }); |
| 50 | + |
| 51 | + function getRemoteArticleInfo( targetId, targetUrl ) { |
| 52 | + $.getJSON( |
| 53 | + targetUrl + '/api.php?callback=?', |
| 54 | + { |
| 55 | + 'action': 'query', |
| 56 | + 'format': 'json', |
| 57 | + 'prop': 'revisions', |
| 58 | + 'rvprop': 'timestamp|user|comment', |
| 59 | + 'titles': $('#pageName').attr('value'), |
| 60 | + }, |
| 61 | + function( data ) { |
| 62 | + if ( data.query ) { |
| 63 | + for ( first in data.query.pages ) break; |
| 64 | + if ( first == '-1' ) { |
| 65 | + $( '#targetlink' + targetId ).attr( {'class': 'new'} ); |
| 66 | + } |
| 67 | + } |
| 68 | + } |
| 69 | + ); |
| 70 | + } |
| 71 | + |
| 72 | + function initiatePush( sender, pageName, targetUrl, targetName ) { |
| 73 | + $.getJSON( |
| 74 | + wgScriptPath + '/api.php', |
| 75 | + { |
| 76 | + 'action': 'push', |
| 77 | + 'format': 'json', |
| 78 | + 'page': pageName, |
| 79 | + 'targets': targetUrl |
| 80 | + }, |
| 81 | + function( data ) { |
| 82 | + if ( data.error ) { |
| 83 | + handleError( sender, targetUrl, data.error ); |
| 84 | + } |
| 85 | + else if ( data.edit && data.edit.captcha ) { |
| 86 | + handleError( sender, targetUrl, { info: mediaWiki.msg( 'push-err-captacha', targetName ) } ); |
| 87 | + } |
| 88 | + else { |
| 89 | + sender.innerHTML = mediaWiki.msg( 'push-button-completed' ); |
| 90 | + setTimeout( function() {reEnableButton( sender );}, 1000 ); |
| 91 | + } |
| 92 | + } |
| 93 | + ); |
| 94 | + } |
| 95 | + |
| 96 | + function reEnableButton( button ) { |
| 97 | + button.innerHTML = mediaWiki.msg( 'push-button-text' ); |
| 98 | + button.disabled = false; |
| 99 | + |
| 100 | + var pushAllButton = $('#push-all-button'); |
| 101 | + |
| 102 | + // If there is a "push all" button, make sure to reset it |
| 103 | + // when all other buttons have been reset. |
| 104 | + if ( typeof pushAllButton !== "undefined" ) { |
| 105 | + var hasDisabled = false; |
| 106 | + |
| 107 | + $.each($(".push-button"), function(i,v) { |
| 108 | + if ( v.disabled ) { |
| 109 | + hasDisabled = true; |
| 110 | + } |
| 111 | + }); |
| 112 | + |
| 113 | + if ( !hasDisabled ) { |
| 114 | + pushAllButton.attr( "disabled", false ); |
| 115 | + pushAllButton.text( mediaWiki.msg( 'push-button-all' ) ); |
| 116 | + } |
| 117 | + } |
| 118 | + } |
| 119 | + |
| 120 | + function handleError( sender, targetUrl, error ) { |
| 121 | + alert( error.info ); |
| 122 | + sender.innerHTML = mediaWiki.msg( 'push-button-failed' ); |
| 123 | + setTimeout( function() {reEnableButton( sender );}, 3000 ); |
| 124 | + } |
| 125 | + |
| 126 | +} ); })(jQuery); |
\ No newline at end of file |
Property changes on: tags/extensions/Push/REL_0_3/includes/ext.push.tab.js |
___________________________________________________________________ |
Added: svn:eol-style |
1 | 127 | + native |
Index: tags/extensions/Push/REL_0_3/Push.hooks.php |
— | — | @@ -0,0 +1,30 @@ |
| 2 | +<?php |
| 3 | + |
| 4 | +/** |
| 5 | + * Static class for hooks handled by the Push extension. |
| 6 | + * |
| 7 | + * @since 0.1 |
| 8 | + * |
| 9 | + * @file Push.hooks.php |
| 10 | + * @ingroup Push |
| 11 | + * |
| 12 | + * @author Jeroen De Dauw < jeroendedauw@gmail.com > |
| 13 | + */ |
| 14 | +final class PushHooks { |
| 15 | + |
| 16 | + /** |
| 17 | + * Adds a link to Admin Links page. |
| 18 | + * |
| 19 | + * @since 0.1 |
| 20 | + * |
| 21 | + * @return true |
| 22 | + */ |
| 23 | + public static function addToAdminLinks( &$admin_links_tree ) { |
| 24 | + $ioSection = $admin_links_tree->getSection( wfMsg( 'adminlinks_importexport' ) ); |
| 25 | + $mainRow = $ioSection->getRow( 'main' ); |
| 26 | + $mainRow->addItem( ALItem::newFromSpecialPage( 'Push' ) ); |
| 27 | + |
| 28 | + return true; |
| 29 | + } |
| 30 | + |
| 31 | +} |
\ No newline at end of file |
Property changes on: tags/extensions/Push/REL_0_3/Push.hooks.php |
___________________________________________________________________ |
Added: svn:eol-style |
1 | 32 | + native |
Index: tags/extensions/Push/REL_0_3/COPYING |
— | — | @@ -0,0 +1,682 @@ |
| 2 | +The license text below "----" applies to all files within this distribution, other |
| 3 | +than those that are in a directory which contains files named "LICENSE" or |
| 4 | +"COPYING", or a subdirectory thereof. For those files, the license text contained in |
| 5 | +said file overrides any license information contained in directories of smaller depth. |
| 6 | +Alternative licenses are typically used for software that is provided by external |
| 7 | +parties, and merely packaged with this software for convenience. |
| 8 | +---- |
| 9 | + |
| 10 | + GNU GENERAL PUBLIC LICENSE |
| 11 | + Version 3, 29 June 2007 |
| 12 | + |
| 13 | + Copyright (C) 2007 Free Software Foundation, Inc. <http://fsf.org/> |
| 14 | + Everyone is permitted to copy and distribute verbatim copies |
| 15 | + of this license document, but changing it is not allowed. |
| 16 | + |
| 17 | + Preamble |
| 18 | + |
| 19 | + The GNU General Public License is a free, copyleft license for |
| 20 | +software and other kinds of works. |
| 21 | + |
| 22 | + The licenses for most software and other practical works are designed |
| 23 | +to take away your freedom to share and change the works. By contrast, |
| 24 | +the GNU General Public License is intended to guarantee your freedom to |
| 25 | +share and change all versions of a program--to make sure it remains free |
| 26 | +software for all its users. We, the Free Software Foundation, use the |
| 27 | +GNU General Public License for most of our software; it applies also to |
| 28 | +any other work released this way by its authors. You can apply it to |
| 29 | +your programs, too. |
| 30 | + |
| 31 | + When we speak of free software, we are referring to freedom, not |
| 32 | +price. Our General Public Licenses are designed to make sure that you |
| 33 | +have the freedom to distribute copies of free software (and charge for |
| 34 | +them if you wish), that you receive source code or can get it if you |
| 35 | +want it, that you can change the software or use pieces of it in new |
| 36 | +free programs, and that you know you can do these things. |
| 37 | + |
| 38 | + To protect your rights, we need to prevent others from denying you |
| 39 | +these rights or asking you to surrender the rights. Therefore, you have |
| 40 | +certain responsibilities if you distribute copies of the software, or if |
| 41 | +you modify it: responsibilities to respect the freedom of others. |
| 42 | + |
| 43 | + For example, if you distribute copies of such a program, whether |
| 44 | +gratis or for a fee, you must pass on to the recipients the same |
| 45 | +freedoms that you received. You must make sure that they, too, receive |
| 46 | +or can get the source code. And you must show them these terms so they |
| 47 | +know their rights. |
| 48 | + |
| 49 | + Developers that use the GNU GPL protect your rights with two steps: |
| 50 | +(1) assert copyright on the software, and (2) offer you this License |
| 51 | +giving you legal permission to copy, distribute and/or modify it. |
| 52 | + |
| 53 | + For the developers' and authors' protection, the GPL clearly explains |
| 54 | +that there is no warranty for this free software. For both users' and |
| 55 | +authors' sake, the GPL requires that modified versions be marked as |
| 56 | +changed, so that their problems will not be attributed erroneously to |
| 57 | +authors of previous versions. |
| 58 | + |
| 59 | + Some devices are designed to deny users access to install or run |
| 60 | +modified versions of the software inside them, although the manufacturer |
| 61 | +can do so. This is fundamentally incompatible with the aim of |
| 62 | +protecting users' freedom to change the software. The systematic |
| 63 | +pattern of such abuse occurs in the area of products for individuals to |
| 64 | +use, which is precisely where it is most unacceptable. Therefore, we |
| 65 | +have designed this version of the GPL to prohibit the practice for those |
| 66 | +products. If such problems arise substantially in other domains, we |
| 67 | +stand ready to extend this provision to those domains in future versions |
| 68 | +of the GPL, as needed to protect the freedom of users. |
| 69 | + |
| 70 | + Finally, every program is threatened constantly by software patents. |
| 71 | +States should not allow patents to restrict development and use of |
| 72 | +software on general-purpose computers, but in those that do, we wish to |
| 73 | +avoid the special danger that patents applied to a free program could |
| 74 | +make it effectively proprietary. To prevent this, the GPL assures that |
| 75 | +patents cannot be used to render the program non-free. |
| 76 | + |
| 77 | + The precise terms and conditions for copying, distribution and |
| 78 | +modification follow. |
| 79 | + |
| 80 | + TERMS AND CONDITIONS |
| 81 | + |
| 82 | + 0. Definitions. |
| 83 | + |
| 84 | + "This License" refers to version 3 of the GNU General Public License. |
| 85 | + |
| 86 | + "Copyright" also means copyright-like laws that apply to other kinds of |
| 87 | +works, such as semiconductor masks. |
| 88 | + |
| 89 | + "The Program" refers to any copyrightable work licensed under this |
| 90 | +License. Each licensee is addressed as "you". "Licensees" and |
| 91 | +"recipients" may be individuals or organizations. |
| 92 | + |
| 93 | + To "modify" a work means to copy from or adapt all or part of the work |
| 94 | +in a fashion requiring copyright permission, other than the making of an |
| 95 | +exact copy. The resulting work is called a "modified version" of the |
| 96 | +earlier work or a work "based on" the earlier work. |
| 97 | + |
| 98 | + A "covered work" means either the unmodified Program or a work based |
| 99 | +on the Program. |
| 100 | + |
| 101 | + To "propagate" a work means to do anything with it that, without |
| 102 | +permission, would make you directly or secondarily liable for |
| 103 | +infringement under applicable copyright law, except executing it on a |
| 104 | +computer or modifying a private copy. Propagation includes copying, |
| 105 | +distribution (with or without modification), making available to the |
| 106 | +public, and in some countries other activities as well. |
| 107 | + |
| 108 | + To "convey" a work means any kind of propagation that enables other |
| 109 | +parties to make or receive copies. Mere interaction with a user through |
| 110 | +a computer network, with no transfer of a copy, is not conveying. |
| 111 | + |
| 112 | + An interactive user interface displays "Appropriate Legal Notices" |
| 113 | +to the extent that it includes a convenient and prominently visible |
| 114 | +feature that (1) displays an appropriate copyright notice, and (2) |
| 115 | +tells the user that there is no warranty for the work (except to the |
| 116 | +extent that warranties are provided), that licensees may convey the |
| 117 | +work under this License, and how to view a copy of this License. If |
| 118 | +the interface presents a list of user commands or options, such as a |
| 119 | +menu, a prominent item in the list meets this criterion. |
| 120 | + |
| 121 | + 1. Source Code. |
| 122 | + |
| 123 | + The "source code" for a work means the preferred form of the work |
| 124 | +for making modifications to it. "Object code" means any non-source |
| 125 | +form of a work. |
| 126 | + |
| 127 | + A "Standard Interface" means an interface that either is an official |
| 128 | +standard defined by a recognized standards body, or, in the case of |
| 129 | +interfaces specified for a particular programming language, one that |
| 130 | +is widely used among developers working in that language. |
| 131 | + |
| 132 | + The "System Libraries" of an executable work include anything, other |
| 133 | +than the work as a whole, that (a) is included in the normal form of |
| 134 | +packaging a Major Component, but which is not part of that Major |
| 135 | +Component, and (b) serves only to enable use of the work with that |
| 136 | +Major Component, or to implement a Standard Interface for which an |
| 137 | +implementation is available to the public in source code form. A |
| 138 | +"Major Component", in this context, means a major essential component |
| 139 | +(kernel, window system, and so on) of the specific operating system |
| 140 | +(if any) on which the executable work runs, or a compiler used to |
| 141 | +produce the work, or an object code interpreter used to run it. |
| 142 | + |
| 143 | + The "Corresponding Source" for a work in object code form means all |
| 144 | +the source code needed to generate, install, and (for an executable |
| 145 | +work) run the object code and to modify the work, including scripts to |
| 146 | +control those activities. However, it does not include the work's |
| 147 | +System Libraries, or general-purpose tools or generally available free |
| 148 | +programs which are used unmodified in performing those activities but |
| 149 | +which are not part of the work. For example, Corresponding Source |
| 150 | +includes interface definition files associated with source files for |
| 151 | +the work, and the source code for shared libraries and dynamically |
| 152 | +linked subprograms that the work is specifically designed to require, |
| 153 | +such as by intimate data communication or control flow between those |
| 154 | +subprograms and other parts of the work. |
| 155 | + |
| 156 | + The Corresponding Source need not include anything that users |
| 157 | +can regenerate automatically from other parts of the Corresponding |
| 158 | +Source. |
| 159 | + |
| 160 | + The Corresponding Source for a work in source code form is that |
| 161 | +same work. |
| 162 | + |
| 163 | + 2. Basic Permissions. |
| 164 | + |
| 165 | + All rights granted under this License are granted for the term of |
| 166 | +copyright on the Program, and are irrevocable provided the stated |
| 167 | +conditions are met. This License explicitly affirms your unlimited |
| 168 | +permission to run the unmodified Program. The output from running a |
| 169 | +covered work is covered by this License only if the output, given its |
| 170 | +content, constitutes a covered work. This License acknowledges your |
| 171 | +rights of fair use or other equivalent, as provided by copyright law. |
| 172 | + |
| 173 | + You may make, run and propagate covered works that you do not |
| 174 | +convey, without conditions so long as your license otherwise remains |
| 175 | +in force. You may convey covered works to others for the sole purpose |
| 176 | +of having them make modifications exclusively for you, or provide you |
| 177 | +with facilities for running those works, provided that you comply with |
| 178 | +the terms of this License in conveying all material for which you do |
| 179 | +not control copyright. Those thus making or running the covered works |
| 180 | +for you must do so exclusively on your behalf, under your direction |
| 181 | +and control, on terms that prohibit them from making any copies of |
| 182 | +your copyrighted material outside their relationship with you. |
| 183 | + |
| 184 | + Conveying under any other circumstances is permitted solely under |
| 185 | +the conditions stated below. Sublicensing is not allowed; section 10 |
| 186 | +makes it unnecessary. |
| 187 | + |
| 188 | + 3. Protecting Users' Legal Rights From Anti-Circumvention Law. |
| 189 | + |
| 190 | + No covered work shall be deemed part of an effective technological |
| 191 | +measure under any applicable law fulfilling obligations under article |
| 192 | +11 of the WIPO copyright treaty adopted on 20 December 1996, or |
| 193 | +similar laws prohibiting or restricting circumvention of such |
| 194 | +measures. |
| 195 | + |
| 196 | + When you convey a covered work, you waive any legal power to forbid |
| 197 | +circumvention of technological measures to the extent such circumvention |
| 198 | +is effected by exercising rights under this License with respect to |
| 199 | +the covered work, and you disclaim any intention to limit operation or |
| 200 | +modification of the work as a means of enforcing, against the work's |
| 201 | +users, your or third parties' legal rights to forbid circumvention of |
| 202 | +technological measures. |
| 203 | + |
| 204 | + 4. Conveying Verbatim Copies. |
| 205 | + |
| 206 | + You may convey verbatim copies of the Program's source code as you |
| 207 | +receive it, in any medium, provided that you conspicuously and |
| 208 | +appropriately publish on each copy an appropriate copyright notice; |
| 209 | +keep intact all notices stating that this License and any |
| 210 | +non-permissive terms added in accord with section 7 apply to the code; |
| 211 | +keep intact all notices of the absence of any warranty; and give all |
| 212 | +recipients a copy of this License along with the Program. |
| 213 | + |
| 214 | + You may charge any price or no price for each copy that you convey, |
| 215 | +and you may offer support or warranty protection for a fee. |
| 216 | + |
| 217 | + 5. Conveying Modified Source Versions. |
| 218 | + |
| 219 | + You may convey a work based on the Program, or the modifications to |
| 220 | +produce it from the Program, in the form of source code under the |
| 221 | +terms of section 4, provided that you also meet all of these conditions: |
| 222 | + |
| 223 | + a) The work must carry prominent notices stating that you modified |
| 224 | + it, and giving a relevant date. |
| 225 | + |
| 226 | + b) The work must carry prominent notices stating that it is |
| 227 | + released under this License and any conditions added under section |
| 228 | + 7. This requirement modifies the requirement in section 4 to |
| 229 | + "keep intact all notices". |
| 230 | + |
| 231 | + c) You must license the entire work, as a whole, under this |
| 232 | + License to anyone who comes into possession of a copy. This |
| 233 | + License will therefore apply, along with any applicable section 7 |
| 234 | + additional terms, to the whole of the work, and all its parts, |
| 235 | + regardless of how they are packaged. This License gives no |
| 236 | + permission to license the work in any other way, but it does not |
| 237 | + invalidate such permission if you have separately received it. |
| 238 | + |
| 239 | + d) If the work has interactive user interfaces, each must display |
| 240 | + Appropriate Legal Notices; however, if the Program has interactive |
| 241 | + interfaces that do not display Appropriate Legal Notices, your |
| 242 | + work need not make them do so. |
| 243 | + |
| 244 | + A compilation of a covered work with other separate and independent |
| 245 | +works, which are not by their nature extensions of the covered work, |
| 246 | +and which are not combined with it such as to form a larger program, |
| 247 | +in or on a volume of a storage or distribution medium, is called an |
| 248 | +"aggregate" if the compilation and its resulting copyright are not |
| 249 | +used to limit the access or legal rights of the compilation's users |
| 250 | +beyond what the individual works permit. Inclusion of a covered work |
| 251 | +in an aggregate does not cause this License to apply to the other |
| 252 | +parts of the aggregate. |
| 253 | + |
| 254 | + 6. Conveying Non-Source Forms. |
| 255 | + |
| 256 | + You may convey a covered work in object code form under the terms |
| 257 | +of sections 4 and 5, provided that you also convey the |
| 258 | +machine-readable Corresponding Source under the terms of this License, |
| 259 | +in one of these ways: |
| 260 | + |
| 261 | + a) Convey the object code in, or embodied in, a physical product |
| 262 | + (including a physical distribution medium), accompanied by the |
| 263 | + Corresponding Source fixed on a durable physical medium |
| 264 | + customarily used for software interchange. |
| 265 | + |
| 266 | + b) Convey the object code in, or embodied in, a physical product |
| 267 | + (including a physical distribution medium), accompanied by a |
| 268 | + written offer, valid for at least three years and valid for as |
| 269 | + long as you offer spare parts or customer support for that product |
| 270 | + model, to give anyone who possesses the object code either (1) a |
| 271 | + copy of the Corresponding Source for all the software in the |
| 272 | + product that is covered by this License, on a durable physical |
| 273 | + medium customarily used for software interchange, for a price no |
| 274 | + more than your reasonable cost of physically performing this |
| 275 | + conveying of source, or (2) access to copy the |
| 276 | + Corresponding Source from a network server at no charge. |
| 277 | + |
| 278 | + c) Convey individual copies of the object code with a copy of the |
| 279 | + written offer to provide the Corresponding Source. This |
| 280 | + alternative is allowed only occasionally and noncommercially, and |
| 281 | + only if you received the object code with such an offer, in accord |
| 282 | + with subsection 6b. |
| 283 | + |
| 284 | + d) Convey the object code by offering access from a designated |
| 285 | + place (gratis or for a charge), and offer equivalent access to the |
| 286 | + Corresponding Source in the same way through the same place at no |
| 287 | + further charge. You need not require recipients to copy the |
| 288 | + Corresponding Source along with the object code. If the place to |
| 289 | + copy the object code is a network server, the Corresponding Source |
| 290 | + may be on a different server (operated by you or a third party) |
| 291 | + that supports equivalent copying facilities, provided you maintain |
| 292 | + clear directions next to the object code saying where to find the |
| 293 | + Corresponding Source. Regardless of what server hosts the |
| 294 | + Corresponding Source, you remain obligated to ensure that it is |
| 295 | + available for as long as needed to satisfy these requirements. |
| 296 | + |
| 297 | + e) Convey the object code using peer-to-peer transmission, provided |
| 298 | + you inform other peers where the object code and Corresponding |
| 299 | + Source of the work are being offered to the general public at no |
| 300 | + charge under subsection 6d. |
| 301 | + |
| 302 | + A separable portion of the object code, whose source code is excluded |
| 303 | +from the Corresponding Source as a System Library, need not be |
| 304 | +included in conveying the object code work. |
| 305 | + |
| 306 | + A "User Product" is either (1) a "consumer product", which means any |
| 307 | +tangible personal property which is normally used for personal, family, |
| 308 | +or household purposes, or (2) anything designed or sold for incorporation |
| 309 | +into a dwelling. In determining whether a product is a consumer product, |
| 310 | +doubtful cases shall be resolved in favor of coverage. For a particular |
| 311 | +product received by a particular user, "normally used" refers to a |
| 312 | +typical or common use of that class of product, regardless of the status |
| 313 | +of the particular user or of the way in which the particular user |
| 314 | +actually uses, or expects or is expected to use, the product. A product |
| 315 | +is a consumer product regardless of whether the product has substantial |
| 316 | +commercial, industrial or non-consumer uses, unless such uses represent |
| 317 | +the only significant mode of use of the product. |
| 318 | + |
| 319 | + "Installation Information" for a User Product means any methods, |
| 320 | +procedures, authorization keys, or other information required to install |
| 321 | +and execute modified versions of a covered work in that User Product from |
| 322 | +a modified version of its Corresponding Source. The information must |
| 323 | +suffice to ensure that the continued functioning of the modified object |
| 324 | +code is in no case prevented or interfered with solely because |
| 325 | +modification has been made. |
| 326 | + |
| 327 | + If you convey an object code work under this section in, or with, or |
| 328 | +specifically for use in, a User Product, and the conveying occurs as |
| 329 | +part of a transaction in which the right of possession and use of the |
| 330 | +User Product is transferred to the recipient in perpetuity or for a |
| 331 | +fixed term (regardless of how the transaction is characterized), the |
| 332 | +Corresponding Source conveyed under this section must be accompanied |
| 333 | +by the Installation Information. But this requirement does not apply |
| 334 | +if neither you nor any third party retains the ability to install |
| 335 | +modified object code on the User Product (for example, the work has |
| 336 | +been installed in ROM). |
| 337 | + |
| 338 | + The requirement to provide Installation Information does not include a |
| 339 | +requirement to continue to provide support service, warranty, or updates |
| 340 | +for a work that has been modified or installed by the recipient, or for |
| 341 | +the User Product in which it has been modified or installed. Access to a |
| 342 | +network may be denied when the modification itself materially and |
| 343 | +adversely affects the operation of the network or violates the rules and |
| 344 | +protocols for communication across the network. |
| 345 | + |
| 346 | + Corresponding Source conveyed, and Installation Information provided, |
| 347 | +in accord with this section must be in a format that is publicly |
| 348 | +documented (and with an implementation available to the public in |
| 349 | +source code form), and must require no special password or key for |
| 350 | +unpacking, reading or copying. |
| 351 | + |
| 352 | + 7. Additional Terms. |
| 353 | + |
| 354 | + "Additional permissions" are terms that supplement the terms of this |
| 355 | +License by making exceptions from one or more of its conditions. |
| 356 | +Additional permissions that are applicable to the entire Program shall |
| 357 | +be treated as though they were included in this License, to the extent |
| 358 | +that they are valid under applicable law. If additional permissions |
| 359 | +apply only to part of the Program, that part may be used separately |
| 360 | +under those permissions, but the entire Program remains governed by |
| 361 | +this License without regard to the additional permissions. |
| 362 | + |
| 363 | + When you convey a copy of a covered work, you may at your option |
| 364 | +remove any additional permissions from that copy, or from any part of |
| 365 | +it. (Additional permissions may be written to require their own |
| 366 | +removal in certain cases when you modify the work.) You may place |
| 367 | +additional permissions on material, added by you to a covered work, |
| 368 | +for which you have or can give appropriate copyright permission. |
| 369 | + |
| 370 | + Notwithstanding any other provision of this License, for material you |
| 371 | +add to a covered work, you may (if authorized by the copyright holders of |
| 372 | +that material) supplement the terms of this License with terms: |
| 373 | + |
| 374 | + a) Disclaiming warranty or limiting liability differently from the |
| 375 | + terms of sections 15 and 16 of this License; or |
| 376 | + |
| 377 | + b) Requiring preservation of specified reasonable legal notices or |
| 378 | + author attributions in that material or in the Appropriate Legal |
| 379 | + Notices displayed by works containing it; or |
| 380 | + |
| 381 | + c) Prohibiting misrepresentation of the origin of that material, or |
| 382 | + requiring that modified versions of such material be marked in |
| 383 | + reasonable ways as different from the original version; or |
| 384 | + |
| 385 | + d) Limiting the use for publicity purposes of names of licensors or |
| 386 | + authors of the material; or |
| 387 | + |
| 388 | + e) Declining to grant rights under trademark law for use of some |
| 389 | + trade names, trademarks, or service marks; or |
| 390 | + |
| 391 | + f) Requiring indemnification of licensors and authors of that |
| 392 | + material by anyone who conveys the material (or modified versions of |
| 393 | + it) with contractual assumptions of liability to the recipient, for |
| 394 | + any liability that these contractual assumptions directly impose on |
| 395 | + those licensors and authors. |
| 396 | + |
| 397 | + All other non-permissive additional terms are considered "further |
| 398 | +restrictions" within the meaning of section 10. If the Program as you |
| 399 | +received it, or any part of it, contains a notice stating that it is |
| 400 | +governed by this License along with a term that is a further |
| 401 | +restriction, you may remove that term. If a license document contains |
| 402 | +a further restriction but permits relicensing or conveying under this |
| 403 | +License, you may add to a covered work material governed by the terms |
| 404 | +of that license document, provided that the further restriction does |
| 405 | +not survive such relicensing or conveying. |
| 406 | + |
| 407 | + If you add terms to a covered work in accord with this section, you |
| 408 | +must place, in the relevant source files, a statement of the |
| 409 | +additional terms that apply to those files, or a notice indicating |
| 410 | +where to find the applicable terms. |
| 411 | + |
| 412 | + Additional terms, permissive or non-permissive, may be stated in the |
| 413 | +form of a separately written license, or stated as exceptions; |
| 414 | +the above requirements apply either way. |
| 415 | + |
| 416 | + 8. Termination. |
| 417 | + |
| 418 | + You may not propagate or modify a covered work except as expressly |
| 419 | +provided under this License. Any attempt otherwise to propagate or |
| 420 | +modify it is void, and will automatically terminate your rights under |
| 421 | +this License (including any patent licenses granted under the third |
| 422 | +paragraph of section 11). |
| 423 | + |
| 424 | + However, if you cease all violation of this License, then your |
| 425 | +license from a particular copyright holder is reinstated (a) |
| 426 | +provisionally, unless and until the copyright holder explicitly and |
| 427 | +finally terminates your license, and (b) permanently, if the copyright |
| 428 | +holder fails to notify you of the violation by some reasonable means |
| 429 | +prior to 60 days after the cessation. |
| 430 | + |
| 431 | + Moreover, your license from a particular copyright holder is |
| 432 | +reinstated permanently if the copyright holder notifies you of the |
| 433 | +violation by some reasonable means, this is the first time you have |
| 434 | +received notice of violation of this License (for any work) from that |
| 435 | +copyright holder, and you cure the violation prior to 30 days after |
| 436 | +your receipt of the notice. |
| 437 | + |
| 438 | + Termination of your rights under this section does not terminate the |
| 439 | +licenses of parties who have received copies or rights from you under |
| 440 | +this License. If your rights have been terminated and not permanently |
| 441 | +reinstated, you do not qualify to receive new licenses for the same |
| 442 | +material under section 10. |
| 443 | + |
| 444 | + 9. Acceptance Not Required for Having Copies. |
| 445 | + |
| 446 | + You are not required to accept this License in order to receive or |
| 447 | +run a copy of the Program. Ancillary propagation of a covered work |
| 448 | +occurring solely as a consequence of using peer-to-peer transmission |
| 449 | +to receive a copy likewise does not require acceptance. However, |
| 450 | +nothing other than this License grants you permission to propagate or |
| 451 | +modify any covered work. These actions infringe copyright if you do |
| 452 | +not accept this License. Therefore, by modifying or propagating a |
| 453 | +covered work, you indicate your acceptance of this License to do so. |
| 454 | + |
| 455 | + 10. Automatic Licensing of Downstream Recipients. |
| 456 | + |
| 457 | + Each time you convey a covered work, the recipient automatically |
| 458 | +receives a license from the original licensors, to run, modify and |
| 459 | +propagate that work, subject to this License. You are not responsible |
| 460 | +for enforcing compliance by third parties with this License. |
| 461 | + |
| 462 | + An "entity transaction" is a transaction transferring control of an |
| 463 | +organization, or substantially all assets of one, or subdividing an |
| 464 | +organization, or merging organizations. If propagation of a covered |
| 465 | +work results from an entity transaction, each party to that |
| 466 | +transaction who receives a copy of the work also receives whatever |
| 467 | +licenses to the work the party's predecessor in interest had or could |
| 468 | +give under the previous paragraph, plus a right to possession of the |
| 469 | +Corresponding Source of the work from the predecessor in interest, if |
| 470 | +the predecessor has it or can get it with reasonable efforts. |
| 471 | + |
| 472 | + You may not impose any further restrictions on the exercise of the |
| 473 | +rights granted or affirmed under this License. For example, you may |
| 474 | +not impose a license fee, royalty, or other charge for exercise of |
| 475 | +rights granted under this License, and you may not initiate litigation |
| 476 | +(including a cross-claim or counterclaim in a lawsuit) alleging that |
| 477 | +any patent claim is infringed by making, using, selling, offering for |
| 478 | +sale, or importing the Program or any portion of it. |
| 479 | + |
| 480 | + 11. Patents. |
| 481 | + |
| 482 | + A "contributor" is a copyright holder who authorizes use under this |
| 483 | +License of the Program or a work on which the Program is based. The |
| 484 | +work thus licensed is called the contributor's "contributor version". |
| 485 | + |
| 486 | + A contributor's "essential patent claims" are all patent claims |
| 487 | +owned or controlled by the contributor, whether already acquired or |
| 488 | +hereafter acquired, that would be infringed by some manner, permitted |
| 489 | +by this License, of making, using, or selling its contributor version, |
| 490 | +but do not include claims that would be infringed only as a |
| 491 | +consequence of further modification of the contributor version. For |
| 492 | +purposes of this definition, "control" includes the right to grant |
| 493 | +patent sublicenses in a manner consistent with the requirements of |
| 494 | +this License. |
| 495 | + |
| 496 | + Each contributor grants you a non-exclusive, worldwide, royalty-free |
| 497 | +patent license under the contributor's essential patent claims, to |
| 498 | +make, use, sell, offer for sale, import and otherwise run, modify and |
| 499 | +propagate the contents of its contributor version. |
| 500 | + |
| 501 | + In the following three paragraphs, a "patent license" is any express |
| 502 | +agreement or commitment, however denominated, not to enforce a patent |
| 503 | +(such as an express permission to practice a patent or covenant not to |
| 504 | +sue for patent infringement). To "grant" such a patent license to a |
| 505 | +party means to make such an agreement or commitment not to enforce a |
| 506 | +patent against the party. |
| 507 | + |
| 508 | + If you convey a covered work, knowingly relying on a patent license, |
| 509 | +and the Corresponding Source of the work is not available for anyone |
| 510 | +to copy, free of charge and under the terms of this License, through a |
| 511 | +publicly available network server or other readily accessible means, |
| 512 | +then you must either (1) cause the Corresponding Source to be so |
| 513 | +available, or (2) arrange to deprive yourself of the benefit of the |
| 514 | +patent license for this particular work, or (3) arrange, in a manner |
| 515 | +consistent with the requirements of this License, to extend the patent |
| 516 | +license to downstream recipients. "Knowingly relying" means you have |
| 517 | +actual knowledge that, but for the patent license, your conveying the |
| 518 | +covered work in a country, or your recipient's use of the covered work |
| 519 | +in a country, would infringe one or more identifiable patents in that |
| 520 | +country that you have reason to believe are valid. |
| 521 | + |
| 522 | + If, pursuant to or in connection with a single transaction or |
| 523 | +arrangement, you convey, or propagate by procuring conveyance of, a |
| 524 | +covered work, and grant a patent license to some of the parties |
| 525 | +receiving the covered work authorizing them to use, propagate, modify |
| 526 | +or convey a specific copy of the covered work, then the patent license |
| 527 | +you grant is automatically extended to all recipients of the covered |
| 528 | +work and works based on it. |
| 529 | + |
| 530 | + A patent license is "discriminatory" if it does not include within |
| 531 | +the scope of its coverage, prohibits the exercise of, or is |
| 532 | +conditioned on the non-exercise of one or more of the rights that are |
| 533 | +specifically granted under this License. You may not convey a covered |
| 534 | +work if you are a party to an arrangement with a third party that is |
| 535 | +in the business of distributing software, under which you make payment |
| 536 | +to the third party based on the extent of your activity of conveying |
| 537 | +the work, and under which the third party grants, to any of the |
| 538 | +parties who would receive the covered work from you, a discriminatory |
| 539 | +patent license (a) in connection with copies of the covered work |
| 540 | +conveyed by you (or copies made from those copies), or (b) primarily |
| 541 | +for and in connection with specific products or compilations that |
| 542 | +contain the covered work, unless you entered into that arrangement, |
| 543 | +or that patent license was granted, prior to 28 March 2007. |
| 544 | + |
| 545 | + Nothing in this License shall be construed as excluding or limiting |
| 546 | +any implied license or other defenses to infringement that may |
| 547 | +otherwise be available to you under applicable patent law. |
| 548 | + |
| 549 | + 12. No Surrender of Others' Freedom. |
| 550 | + |
| 551 | + If conditions are imposed on you (whether by court order, agreement or |
| 552 | +otherwise) that contradict the conditions of this License, they do not |
| 553 | +excuse you from the conditions of this License. If you cannot convey a |
| 554 | +covered work so as to satisfy simultaneously your obligations under this |
| 555 | +License and any other pertinent obligations, then as a consequence you may |
| 556 | +not convey it at all. For example, if you agree to terms that obligate you |
| 557 | +to collect a royalty for further conveying from those to whom you convey |
| 558 | +the Program, the only way you could satisfy both those terms and this |
| 559 | +License would be to refrain entirely from conveying the Program. |
| 560 | + |
| 561 | + 13. Use with the GNU Affero General Public License. |
| 562 | + |
| 563 | + Notwithstanding any other provision of this License, you have |
| 564 | +permission to link or combine any covered work with a work licensed |
| 565 | +under version 3 of the GNU Affero General Public License into a single |
| 566 | +combined work, and to convey the resulting work. The terms of this |
| 567 | +License will continue to apply to the part which is the covered work, |
| 568 | +but the special requirements of the GNU Affero General Public License, |
| 569 | +section 13, concerning interaction through a network will apply to the |
| 570 | +combination as such. |
| 571 | + |
| 572 | + 14. Revised Versions of this License. |
| 573 | + |
| 574 | + The Free Software Foundation may publish revised and/or new versions of |
| 575 | +the GNU General Public License from time to time. Such new versions will |
| 576 | +be similar in spirit to the present version, but may differ in detail to |
| 577 | +address new problems or concerns. |
| 578 | + |
| 579 | + Each version is given a distinguishing version number. If the |
| 580 | +Program specifies that a certain numbered version of the GNU General |
| 581 | +Public License "or any later version" applies to it, you have the |
| 582 | +option of following the terms and conditions either of that numbered |
| 583 | +version or of any later version published by the Free Software |
| 584 | +Foundation. If the Program does not specify a version number of the |
| 585 | +GNU General Public License, you may choose any version ever published |
| 586 | +by the Free Software Foundation. |
| 587 | + |
| 588 | + If the Program specifies that a proxy can decide which future |
| 589 | +versions of the GNU General Public License can be used, that proxy's |
| 590 | +public statement of acceptance of a version permanently authorizes you |
| 591 | +to choose that version for the Program. |
| 592 | + |
| 593 | + Later license versions may give you additional or different |
| 594 | +permissions. However, no additional obligations are imposed on any |
| 595 | +author or copyright holder as a result of your choosing to follow a |
| 596 | +later version. |
| 597 | + |
| 598 | + 15. Disclaimer of Warranty. |
| 599 | + |
| 600 | + THERE IS NO WARRANTY FOR THE PROGRAM, TO THE EXTENT PERMITTED BY |
| 601 | +APPLICABLE LAW. EXCEPT WHEN OTHERWISE STATED IN WRITING THE COPYRIGHT |
| 602 | +HOLDERS AND/OR OTHER PARTIES PROVIDE THE PROGRAM "AS IS" WITHOUT WARRANTY |
| 603 | +OF ANY KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, |
| 604 | +THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR |
| 605 | +PURPOSE. THE ENTIRE RISK AS TO THE QUALITY AND PERFORMANCE OF THE PROGRAM |
| 606 | +IS WITH YOU. SHOULD THE PROGRAM PROVE DEFECTIVE, YOU ASSUME THE COST OF |
| 607 | +ALL NECESSARY SERVICING, REPAIR OR CORRECTION. |
| 608 | + |
| 609 | + 16. Limitation of Liability. |
| 610 | + |
| 611 | + IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN WRITING |
| 612 | +WILL ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MODIFIES AND/OR CONVEYS |
| 613 | +THE PROGRAM AS PERMITTED ABOVE, BE LIABLE TO YOU FOR DAMAGES, INCLUDING ANY |
| 614 | +GENERAL, SPECIAL, INCIDENTAL OR CONSEQUENTIAL DAMAGES ARISING OUT OF THE |
| 615 | +USE OR INABILITY TO USE THE PROGRAM (INCLUDING BUT NOT LIMITED TO LOSS OF |
| 616 | +DATA OR DATA BEING RENDERED INACCURATE OR LOSSES SUSTAINED BY YOU OR THIRD |
| 617 | +PARTIES OR A FAILURE OF THE PROGRAM TO OPERATE WITH ANY OTHER PROGRAMS), |
| 618 | +EVEN IF SUCH HOLDER OR OTHER PARTY HAS BEEN ADVISED OF THE POSSIBILITY OF |
| 619 | +SUCH DAMAGES. |
| 620 | + |
| 621 | + 17. Interpretation of Sections 15 and 16. |
| 622 | + |
| 623 | + If the disclaimer of warranty and limitation of liability provided |
| 624 | +above cannot be given local legal effect according to their terms, |
| 625 | +reviewing courts shall apply local law that most closely approximates |
| 626 | +an absolute waiver of all civil liability in connection with the |
| 627 | +Program, unless a warranty or assumption of liability accompanies a |
| 628 | +copy of the Program in return for a fee. |
| 629 | + |
| 630 | + END OF TERMS AND CONDITIONS |
| 631 | + |
| 632 | + How to Apply These Terms to Your New Programs |
| 633 | + |
| 634 | + If you develop a new program, and you want it to be of the greatest |
| 635 | +possible use to the public, the best way to achieve this is to make it |
| 636 | +free software which everyone can redistribute and change under these terms. |
| 637 | + |
| 638 | + To do so, attach the following notices to the program. It is safest |
| 639 | +to attach them to the start of each source file to most effectively |
| 640 | +state the exclusion of warranty; and each file should have at least |
| 641 | +the "copyright" line and a pointer to where the full notice is found. |
| 642 | + |
| 643 | + <one line to give the program's name and a brief idea of what it does.> |
| 644 | + Copyright (C) <year> <name of author> |
| 645 | + |
| 646 | + This program is free software: you can redistribute it and/or modify |
| 647 | + it under the terms of the GNU General Public License as published by |
| 648 | + the Free Software Foundation, either version 3 of the License, or |
| 649 | + (at your option) any later version. |
| 650 | + |
| 651 | + This program is distributed in the hope that it will be useful, |
| 652 | + but WITHOUT ANY WARRANTY; without even the implied warranty of |
| 653 | + MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the |
| 654 | + GNU General Public License for more details. |
| 655 | + |
| 656 | + You should have received a copy of the GNU General Public License |
| 657 | + along with this program. If not, see <http://www.gnu.org/licenses/>. |
| 658 | + |
| 659 | +Also add information on how to contact you by electronic and paper mail. |
| 660 | + |
| 661 | + If the program does terminal interaction, make it output a short |
| 662 | +notice like this when it starts in an interactive mode: |
| 663 | + |
| 664 | + <program> Copyright (C) <year> <name of author> |
| 665 | + This program comes with ABSOLUTELY NO WARRANTY; for details type `show w'. |
| 666 | + This is free software, and you are welcome to redistribute it |
| 667 | + under certain conditions; type `show c' for details. |
| 668 | + |
| 669 | +The hypothetical commands `show w' and `show c' should show the appropriate |
| 670 | +parts of the General Public License. Of course, your program's commands |
| 671 | +might be different; for a GUI interface, you would use an "about box". |
| 672 | + |
| 673 | + You should also get your employer (if you work as a programmer) or school, |
| 674 | +if any, to sign a "copyright disclaimer" for the program, if necessary. |
| 675 | +For more information on this, and how to apply and follow the GNU GPL, see |
| 676 | +<http://www.gnu.org/licenses/>. |
| 677 | + |
| 678 | + The GNU General Public License does not permit incorporating your program |
| 679 | +into proprietary programs. If your program is a subroutine library, you |
| 680 | +may consider it more useful to permit linking proprietary applications with |
| 681 | +the library. If this is what you want to do, use the GNU Lesser General |
| 682 | +Public License instead of this License. But first, please read |
| 683 | +<http://www.gnu.org/philosophy/why-not-lgpl.html>. |
\ No newline at end of file |
Index: tags/extensions/Push/REL_0_3/api/ApiPush.php |
— | — | @@ -0,0 +1,257 @@ |
| 2 | +<?php |
| 3 | + |
| 4 | +/** |
| 5 | + * API module to push wiki pages to other MediaWiki wikis. |
| 6 | + * |
| 7 | + * @since 0.3 |
| 8 | + * |
| 9 | + * @file ApiPush.php |
| 10 | + * @ingroup Push |
| 11 | + * |
| 12 | + * @author Jeroen De Dauw < jeroendedauw@gmail.com > |
| 13 | + */ |
| 14 | +class ApiPush extends ApiBase { |
| 15 | + |
| 16 | + public function __construct( $main, $action ) { |
| 17 | + parent::__construct( $main, $action ); |
| 18 | + } |
| 19 | + |
| 20 | + public function execute() { |
| 21 | + $params = $this->extractRequestParams(); |
| 22 | + |
| 23 | + if ( !isset( $params['page'] ) ) { |
| 24 | + $this->dieUsageMsg( array( 'missingparam', 'page' ) ); |
| 25 | + } |
| 26 | + |
| 27 | + if ( !isset( $params['targets'] ) ) { |
| 28 | + $this->dieUsageMsg( array( 'missingparam', 'targets' ) ); |
| 29 | + } |
| 30 | + |
| 31 | + $title = Title::newFromText( $params['page'] ); |
| 32 | + |
| 33 | + $revision = $this->getPageRevision( $title ); |
| 34 | + |
| 35 | + if ( $revision !== false ) { |
| 36 | + $this->doPush( $title, $revision, $params['targets'] ); |
| 37 | + } |
| 38 | + } |
| 39 | + |
| 40 | + /** |
| 41 | + * Makes an internal request to the API to get the needed revision. |
| 42 | + * |
| 43 | + * @since 0.3 |
| 44 | + * |
| 45 | + * @param Title $title |
| 46 | + * |
| 47 | + * @return array or false |
| 48 | + */ |
| 49 | + protected function getPageRevision( Title $title ) { |
| 50 | + $revId = PushFunctions::getRevisionToPush( $title ); |
| 51 | + |
| 52 | + $requestData = array( |
| 53 | + 'action' => 'query', |
| 54 | + 'format' => 'json', |
| 55 | + 'prop' => 'revisions', |
| 56 | + 'rvprop' => 'timestamp|user|comment|content', |
| 57 | + 'titles' => $title->getFullText(), |
| 58 | + 'rvstartid' => $revId, |
| 59 | + 'rvendid' => $revId, |
| 60 | + ); |
| 61 | + |
| 62 | + $api = new ApiMain( new FauxRequest( $requestData, true ), true ); |
| 63 | + $api->execute(); |
| 64 | + $response = $api->getResultData(); |
| 65 | + |
| 66 | + $revision = false; |
| 67 | + |
| 68 | + if ( $response !== false |
| 69 | + && array_key_exists( 'query', $response ) |
| 70 | + && array_key_exists( 'pages', $response['query'] ) |
| 71 | + && count( $response['query']['pages'] ) > 0 ) { |
| 72 | + |
| 73 | + foreach ( $response['query']['pages'] as $key => $value ) { |
| 74 | + $first = $key; |
| 75 | + break; |
| 76 | + } |
| 77 | + |
| 78 | + if ( array_key_exists( 'revisions', $response['query']['pages'][$first] ) |
| 79 | + && count( $response['query']['pages'][$first]['revisions'] ) > 0 ) { |
| 80 | + $revision = $response['query']['pages'][$first]['revisions'][0]; |
| 81 | + } |
| 82 | + else { |
| 83 | + $this->dieUsage( wfMsg( 'push-special-err-pageget-failed' ), 'page-get-failed' ); |
| 84 | + } |
| 85 | + } |
| 86 | + else { |
| 87 | + $this->dieUsage( wfMsg( 'push-special-err-pageget-failed' ), 'page-get-failed' ); |
| 88 | + } |
| 89 | + |
| 90 | + return $revision; |
| 91 | + } |
| 92 | + |
| 93 | + /** |
| 94 | + * Pushes the page content to the target wikis. |
| 95 | + * |
| 96 | + * @since 0.3 |
| 97 | + * |
| 98 | + * @param Title $title |
| 99 | + * @param array $revision |
| 100 | + * @param array $targets |
| 101 | + */ |
| 102 | + protected function doPush( Title $title, array $revision, array $targets ) { |
| 103 | + foreach ( $targets as $target ) { |
| 104 | + if ( substr( $target, -1 ) !== '/' ) { |
| 105 | + $target .= '/'; |
| 106 | + } |
| 107 | + |
| 108 | + $target .= 'api.php'; |
| 109 | + |
| 110 | + $token = $this->getEditToken( $title, $target ); |
| 111 | + |
| 112 | + if ( $token !== false ) { |
| 113 | + $this->pushToTarget( $title, $revision, $target, $token ); |
| 114 | + } |
| 115 | + } |
| 116 | + } |
| 117 | + |
| 118 | + /** |
| 119 | + * Obtains the needed edit token by making an HTTP GET request |
| 120 | + * to the remote wikis API. |
| 121 | + * |
| 122 | + * @since 0.3 |
| 123 | + * |
| 124 | + * @param Title $title |
| 125 | + * @param string $target |
| 126 | + * |
| 127 | + * @return string or false |
| 128 | + */ |
| 129 | + protected function getEditToken( Title $title, $target ) { |
| 130 | + $requestData = array( |
| 131 | + 'action' => 'query', |
| 132 | + 'format' => 'json', |
| 133 | + 'intoken' => 'edit', |
| 134 | + 'prop' => 'info', |
| 135 | + 'titles' => $title->getFullText(), |
| 136 | + ); |
| 137 | + |
| 138 | + $parts = array(); |
| 139 | + |
| 140 | + foreach ( $requestData as $key => $value ) { |
| 141 | + $parts[] = $key . '=' . urlencode( $value ); |
| 142 | + } |
| 143 | + |
| 144 | + $response = FormatJson::decode( Http::get( $target . '?' . implode( '&', $parts ) ) ); |
| 145 | + $token = false; |
| 146 | + |
| 147 | + if ( !is_null( $response ) |
| 148 | + && property_exists( $response, 'query' ) |
| 149 | + && property_exists( $response->query, 'pages' ) |
| 150 | + && count( $response->query->pages ) > 0 ) { |
| 151 | + |
| 152 | + foreach ( $response->query->pages as $key => $value ) { |
| 153 | + $first = $key; |
| 154 | + break; |
| 155 | + } |
| 156 | + |
| 157 | + if ( property_exists( $response->query->pages->$first, 'edittoken' ) ) { |
| 158 | + $token = $response->query->pages->$first->edittoken; |
| 159 | + } |
| 160 | + elseif ( !is_null( $response ) && property_exists( $response, 'query' ) && property_exists( $response->query, 'error' ) ) { |
| 161 | + $this->dieUsage( $response->query->error->message, 'token-request-failed' ); |
| 162 | + } |
| 163 | + else { |
| 164 | + $this->dieUsage( wfMsg( 'push-special-err-token-failed' ), 'token-request-failed' ); |
| 165 | + } |
| 166 | + } |
| 167 | + else { |
| 168 | + $this->dieUsage( wfMsg( 'push-special-err-token-failed' ), 'token-request-failed' ); |
| 169 | + } |
| 170 | + |
| 171 | + return $token; |
| 172 | + } |
| 173 | + |
| 174 | + /** |
| 175 | + * Pushes the page content to the specified wiki. |
| 176 | + * |
| 177 | + * @since 0.3 |
| 178 | + * |
| 179 | + * @param Title $title |
| 180 | + * @param array $revision |
| 181 | + * @param string $target |
| 182 | + * @param string $token |
| 183 | + */ |
| 184 | + protected function pushToTarget( Title $title, array $revision, $target, $token ) { |
| 185 | + global $wgSitename; |
| 186 | + |
| 187 | + $summary = wfMsgExt( |
| 188 | + 'push-import-revision-message', |
| 189 | + 'parsemag', |
| 190 | + $wgSitename, |
| 191 | + $revision['user'], |
| 192 | + $revision['comment'] == '' ? '' : wfMsgExt( 'push-import-revision-comment', 'parsemag', $revision['comment'] ) |
| 193 | + ); |
| 194 | + |
| 195 | + $requestData = array( |
| 196 | + 'action' => 'edit', |
| 197 | + 'title' => $title->getFullText(), |
| 198 | + 'format' => 'json', |
| 199 | + 'summary' => $summary, |
| 200 | + 'text' => $revision['*'], |
| 201 | + 'token' => $token, |
| 202 | + ); |
| 203 | + |
| 204 | + $response = Http::post( $target, array( 'postData' => $requestData ) ); |
| 205 | + |
| 206 | + if ( $response !== false ) { |
| 207 | + die( $response ); |
| 208 | + } |
| 209 | + else { |
| 210 | + $this->dieUsage( wfMsg( 'push-special-err-push-failed' ), 'page-push-failed' ); |
| 211 | + } |
| 212 | + } |
| 213 | + |
| 214 | + public function getAllowedParams() { |
| 215 | + return array( |
| 216 | + 'page' => array( |
| 217 | + ApiBase::PARAM_TYPE => 'string', |
| 218 | + //ApiBase::PARAM_REQUIRED => true, |
| 219 | + ), |
| 220 | + 'targets' => array( |
| 221 | + ApiBase::PARAM_TYPE => 'string', |
| 222 | + ApiBase::PARAM_ISMULTI => true, |
| 223 | + //ApiBase::PARAM_REQUIRED => true, |
| 224 | + ), |
| 225 | + ); |
| 226 | + } |
| 227 | + |
| 228 | + public function getParamDescription() { |
| 229 | + return array( |
| 230 | + 'page' => 'The name of the page to push.', |
| 231 | + 'targets' => 'The urls of the wikis to push to.', |
| 232 | + ); |
| 233 | + } |
| 234 | + |
| 235 | + public function getDescription() { |
| 236 | + return array( |
| 237 | + 'Pushes page contnet to other wikis.' |
| 238 | + ); |
| 239 | + } |
| 240 | + |
| 241 | + public function getPossibleErrors() { |
| 242 | + return array_merge( parent::getPossibleErrors(), array( |
| 243 | + array( 'missingparam', 'page' ), |
| 244 | + array( 'missingparam', 'targets' ), |
| 245 | + ) ); |
| 246 | + } |
| 247 | + |
| 248 | + protected function getExamples() { |
| 249 | + return array( |
| 250 | + 'api.php?action=push&page=Main page&targets=http://en.wikipedia.org/w', |
| 251 | + ); |
| 252 | + } |
| 253 | + |
| 254 | + public function getVersion() { |
| 255 | + return __CLASS__ . ': $Id: ApiPush.php 63775 2010-03-15 16:35:22Z jeroendedauw $'; |
| 256 | + } |
| 257 | + |
| 258 | +} |
Property changes on: tags/extensions/Push/REL_0_3/api/ApiPush.php |
___________________________________________________________________ |
Added: svn:eol-style |
1 | 259 | + native |
Index: tags/extensions/Push/REL_0_3/Push.alias.php |
— | — | @@ -0,0 +1,23 @@ |
| 2 | +<?php |
| 3 | +/** |
| 4 | + * Aliases for the special pages of the Push extension. |
| 5 | + * |
| 6 | + * @file Push.alias.php |
| 7 | + * @ingroup Push |
| 8 | + * |
| 9 | + * @author Jeroen De Dauw |
| 10 | + */ |
| 11 | + |
| 12 | +$specialPageAliases = array(); |
| 13 | + |
| 14 | +/** English |
| 15 | + * @author Jeroen De Dauw |
| 16 | + */ |
| 17 | +$specialPageAliases['en'] = array( |
| 18 | + 'Push' => array( 'Push' ), |
| 19 | +); |
| 20 | + |
| 21 | +/** |
| 22 | + * For backwards compatibility with MediaWiki 1.15 and earlier. |
| 23 | + */ |
| 24 | +$aliases =& $specialPageAliases; |
\ No newline at end of file |
Property changes on: tags/extensions/Push/REL_0_3/Push.alias.php |
___________________________________________________________________ |
Added: svn:eol-style |
1 | 25 | + native |
Index: tags/extensions/Push/REL_0_3/README |
— | — | @@ -0,0 +1,9 @@ |
| 2 | +These is the readme file for the Push extension. |
| 3 | + |
| 4 | +Extension page on mediawiki.org: http://www.mediawiki.org/wiki/Extension:Push |
| 5 | +Latest version of the readme file: http://svn.wikimedia.org/viewvc/mediawiki/trunk/extensions/Push/README?view=co |
| 6 | + |
| 7 | +== About == |
| 8 | + |
| 9 | +The Push extension is a simple leightwieght tool that adds an extra tab to artciles that |
| 10 | +allows users to push the content of the article to another MediaWiki wiki. |
\ No newline at end of file |