Index: tags/extensions/Push/REL_0_5/Push.i18n.php |
— | — | @@ -0,0 +1,499 @@ |
| 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 | + 'push-err-captcha-page' => 'Could not push page $1 to all targets due to CAPTCHA.', |
| 27 | + 'push-err-authentication' => 'Authentication at $1 failed. $2', |
| 28 | + |
| 29 | + // Tab |
| 30 | + 'push-tab-text' => 'Push', |
| 31 | + 'push-button-text' => 'Push', |
| 32 | + 'push-tab-desc' => 'This tab allows you to push the current revision of this page to one or more other wikis.', |
| 33 | + 'push-button-pushing' => 'Pushing', |
| 34 | + 'push-button-pushing-files' => 'Pushing files', |
| 35 | + 'push-button-completed' => 'Push completed', |
| 36 | + 'push-button-failed' => 'Push failed', |
| 37 | + 'push-tab-title' => 'Push $1', |
| 38 | + 'push-targets' => 'Push targets', |
| 39 | + 'push-add-target' => 'Add target', |
| 40 | + 'push-import-revision-message' => 'Pushed from $1 by $2.', |
| 41 | + 'push-tab-no-targets' => 'There are no targets to push to. Please add some to your LocalSettings.php file.', |
| 42 | + 'push-tab-push-to' => 'Push to $1', |
| 43 | + 'push-remote-pages' => 'Remote pages', |
| 44 | + 'push-remote-page-link' => '$1 on $2', |
| 45 | + 'push-remote-page-link-full' => 'View $1 on $2', |
| 46 | + 'push-targets-total' => 'There are a total of $1 {{PLURAL:$1|target|targets}}.', |
| 47 | + 'push-button-all' => 'Push all', |
| 48 | + 'push-tab-last-edit' => 'Last edit by $1 on $2 at $3.', |
| 49 | + 'push-tab-not-created' => 'This page does not exist yet.', |
| 50 | + 'push-tab-push-options' => 'Push options:', |
| 51 | + 'push-tab-inc-templates' => 'Include templates', |
| 52 | + 'push-tab-used-templates' => '(Used {{PLURAL:$2|template|templates}}: $1)', |
| 53 | + 'push-tab-no-used-templates' => '(No templates are used on this page.)', |
| 54 | + 'push-tab-inc-files' => 'Include files', |
| 55 | + 'push-tab-err-fileinfo' => 'Could not obtain which files are used on this page. None have been pushed.', |
| 56 | + 'push-tab-err-filepush-unknown' => 'File push failed for an unknown reason.', |
| 57 | + 'push-tab-err-filepush' => 'File push failed: $1', |
| 58 | + |
| 59 | + // Special page |
| 60 | + 'special-push' => 'Push pages', |
| 61 | + 'push-special-description' => 'This page enables you to push content of one or more pages to one or more MediaWiki wikis. |
| 62 | + |
| 63 | +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.', |
| 64 | + 'push-special-pushing-desc' => 'Pushing $2 {{PLURAL:$2|page|pages}} to $1...', |
| 65 | + 'push-special-button-text' => 'Push pages', |
| 66 | + 'push-special-target-is' => 'Target wiki: $1', |
| 67 | + 'push-special-select-targets' => 'Target wikis:', |
| 68 | + 'push-special-item-pushing' => '$1: Pushing', |
| 69 | + 'push-special-item-completed' => '$1: Push completed', |
| 70 | + 'push-special-item-failed' => '$1: Push failed: $2', |
| 71 | + 'push-special-push-done' => 'Push completed', |
| 72 | + 'push-special-err-token-failed' => 'Could not obtain an edit token on the target wiki.', |
| 73 | + 'push-special-err-pageget-failed' => 'Could not obtain local page content.', |
| 74 | + 'push-special-err-push-failed' => 'Target wiki refused the pushed page.', |
| 75 | + 'push-special-inc-files' => 'Include files', |
| 76 | + 'push-special-err-imginfo-failed' => 'Could not determine if any files needed to be pushed.', |
| 77 | + 'push-special-obtaining-fileinfo' => '$1: Obtaining file information...', |
| 78 | + 'push-special-pushing-file' => '$1: Pushing file $2...', |
| 79 | + 'push-special-return' => 'Push more pages', |
| 80 | +); |
| 81 | + |
| 82 | +/** Message documentation (Message documentation) |
| 83 | + * @author Jeroen De Dauw |
| 84 | + * @author Nike |
| 85 | + */ |
| 86 | +$messages['qqq'] = array( |
| 87 | + 'push-err-authentication' => '$1: wiki name, $2: optional detailed error message', |
| 88 | + 'push-remote-page-link' => '$1: page name, $2: wiki name', |
| 89 | + 'push-remote-page-link-full' => '$1: page name, $2: wiki name', |
| 90 | +); |
| 91 | + |
| 92 | +/** Belarusian (Taraškievica orthography) (Беларуская (тарашкевіца)) |
| 93 | + * @author EugeneZelenko |
| 94 | + * @author Jim-by |
| 95 | + */ |
| 96 | +$messages['be-tarask'] = array( |
| 97 | + 'push-desc' => 'Невялікае пашырэньне для распаўсюджваньня зьместу ў іншыя вікі', |
| 98 | + 'right-push' => 'выкарыстаньне распаўсюджваньня', |
| 99 | + 'right-bulkpush' => 'выкарыстаньне групавога распаўсюджваньня', |
| 100 | + 'right-pushadmin' => 'зьмена мэтаў і наладаў распаўсюджваньня', |
| 101 | + 'push-err-captacha' => 'Немагчыма распаўсюдзіць у $1 з-за captcha.', |
| 102 | + 'push-err-captcha-page' => 'Немагчыма распаўсюдзіць старонку $1 на ўсе мэты з-за captcha.', |
| 103 | + 'push-err-authentication' => 'Аўтэнтыфікацыя на $1 не атрымалася. $2', |
| 104 | + 'push-tab-text' => 'Распаўсюдзіць', |
| 105 | + 'push-button-text' => 'Распаўсюдзіць', |
| 106 | + 'push-tab-desc' => 'Гэтая закладка дазваляе Вам распаўсюджваць цяперашнюю вэрсію гэтай старонкі ў іншыя вікі.', |
| 107 | + 'push-button-pushing' => 'Распаўсюджваньне', |
| 108 | + 'push-button-completed' => 'Распаўсюджваньне скончанае', |
| 109 | + 'push-button-failed' => 'Памылка распаўсюджваньня', |
| 110 | + 'push-tab-title' => 'Распаўсюджваньне $1', |
| 111 | + 'push-targets' => 'Мэты распаўсюджваньня', |
| 112 | + 'push-add-target' => 'Дадаць мэту', |
| 113 | + 'push-import-revision-message' => 'Распаўсюджаная з $1 $2. $3', |
| 114 | + 'push-import-revision-comment' => 'Апошні камэнтар: $1', |
| 115 | + 'push-tab-no-targets' => 'Няма мэтаў для распаўсюджаньня. Калі ласка, дадайце некаторыя ў Ваш файл LocalSettings.php.', |
| 116 | + 'push-tab-push-to' => 'Распаўсюдзіць у $1', |
| 117 | + 'push-remote-pages' => 'Аддаленыя старонкі', |
| 118 | +); |
| 119 | + |
| 120 | +/** Breton (Brezhoneg) |
| 121 | + * @author Y-M D |
| 122 | + */ |
| 123 | +$messages['br'] = array( |
| 124 | + 'push-tab-text' => 'Bountañ', |
| 125 | + 'push-button-text' => 'Bountañ', |
| 126 | +); |
| 127 | + |
| 128 | +/** German (Deutsch) |
| 129 | + * @author Kghbln |
| 130 | + */ |
| 131 | +$messages['de'] = array( |
| 132 | + 'push-desc' => 'Ermöglicht den einfachen Transfer von Inhalten eines Wikis in ein anderes', |
| 133 | + 'right-push' => 'Seiten in andere Wikis transferieren', |
| 134 | + 'right-bulkpush' => 'Seiten gesammelt in andere Wikis transferieren', |
| 135 | + 'right-pushadmin' => 'Transfereinstellungen und -ziele ändern', |
| 136 | + 'push-err-captacha' => 'Transfer nach $1 aufgrund eines CAPTCHAs nicht möglich.', |
| 137 | + 'push-err-captcha-page' => 'Seite $1 konnte aufgrund von CAPTCHAs zu keinem der Ziele transferiert werden.', |
| 138 | + 'push-err-authentication' => 'Authentifizierung auf $1 ist fehlgeschlagen. $2', |
| 139 | + 'push-tab-text' => 'Transferieren', |
| 140 | + 'push-button-text' => 'Transferieren', |
| 141 | + 'push-tab-desc' => 'Dieser Reiter ermöglicht den Transfer des aktuellen Seiteninhalts in ein oder mehrere andere Wikis.', |
| 142 | + 'push-button-pushing' => 'Transferiere', |
| 143 | + 'push-button-pushing-files' => 'Transferiere Dateien', |
| 144 | + 'push-button-completed' => 'Transfer abgeschlossen', |
| 145 | + 'push-button-failed' => 'Transfer fehlgeschlagen', |
| 146 | + 'push-tab-title' => 'Transferiere $1', |
| 147 | + 'push-targets' => 'Transferziele', |
| 148 | + 'push-add-target' => 'Transferziel hinzufügen', |
| 149 | + 'push-import-revision-message' => 'Transferiert von $1 durch Benutzer $2. $3', |
| 150 | + 'push-import-revision-comment' => 'Letzter Kommentar: $1', |
| 151 | + 'push-tab-no-targets' => 'Es sind keine Transferziele vorhanden. Es müssen welche in der Datei LocalSettings.php definiert werden.', |
| 152 | + 'push-tab-push-to' => 'Transferiere nach $1', |
| 153 | + 'push-remote-pages' => 'Entfernte Seiten', |
| 154 | + 'push-remote-page-link' => 'Seite $1 auf Wiki $2', |
| 155 | + 'push-remote-page-link-full' => 'Seite $1 auf Wiki $2 ansehen', |
| 156 | + 'push-targets-total' => 'Es {{PLURAL:$1|ist|sind}} insgesamt $1 {{PLURAL:$1|Transferziel|Transferziele}} vorhanden.', |
| 157 | + 'push-button-all' => 'Alle transferieren', |
| 158 | + 'push-tab-last-edit' => 'Letzte Bearbeitung durch Benutzer $1 am $2 um $3 Uhr.', |
| 159 | + 'push-tab-not-created' => 'Diese Seite ist nicht vorhanden.', |
| 160 | + 'push-tab-push-options' => 'Transferoptionen:', |
| 161 | + 'push-tab-inc-templates' => 'Vorlagen einbeziehen', |
| 162 | + 'push-tab-used-templates' => '({{PLURAL:$2|Vorlage|Vorlagen}} eingesetzt: $1)', |
| 163 | + 'push-tab-no-used-templates' => '(Auf dieser Seite werden keine Vorlagen eingesetzt.)', |
| 164 | + 'push-tab-inc-files' => 'Dateien einbeziehen', |
| 165 | + 'push-tab-err-fileinfo' => 'Es konnte nicht ermittelt werden, welche Dateien auf dieser Seite eingebunden sind. Es wurde keine transferiert.', |
| 166 | + 'special-push' => 'Seiten transferieren', |
| 167 | + 'push-special-description' => 'Diese Spezialseite ermöglicht es den Inhalt einer oder mehrerer Seiten zu einem oder mehreren anderen Wikis zu transferieren. |
| 168 | + |
| 169 | +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.', |
| 170 | + 'push-special-pushing-desc' => 'Transferiere $2 {{PLURAL:$2|Seite|Seiten}} nach $1 …', |
| 171 | + 'push-special-button-text' => 'Seiten transferieren', |
| 172 | + 'push-special-target-is' => 'Zielwiki: $1', |
| 173 | + 'push-special-select-targets' => 'Zielwikis:', |
| 174 | + 'push-special-item-pushing' => '$1: Transferiere …', |
| 175 | + 'push-special-item-completed' => '$1: Transfer abgeschlossen', |
| 176 | + 'push-special-item-failed' => '$1: Transfer fehlgeschlagen. $2', |
| 177 | + 'push-special-push-done' => 'Transfer abgeschlossen', |
| 178 | + 'push-special-err-token-failed' => 'Auf dem Zielwiki konnte der Bearbeitungstoken nicht abgerufen werden.', |
| 179 | + 'push-special-err-pageget-failed' => 'Auf diesem Wiki konnte der Seiteninhalt nicht abgerufen werden.', |
| 180 | + 'push-special-err-push-failed' => 'Das Zielwiki hat die zu transferierende Seite zurückgewiesen.', |
| 181 | + 'push-special-inc-files' => 'Dateien einbeziehen', |
| 182 | + 'push-special-err-imginfo-failed' => 'Es konnte nicht ermittelt werden, ob auch Dateien transferiert werden müssen.', |
| 183 | + 'push-special-obtaining-fileinfo' => '$1: Dateiinformationen werden abrufen …', |
| 184 | + 'push-special-pushing-file' => '$1: Transferiere Datei $2 …', |
| 185 | + 'push-special-return' => 'Weitere Seiten transferieren', |
| 186 | +); |
| 187 | + |
| 188 | +/** Finnish (Suomi) |
| 189 | + * @author Tofu II |
| 190 | + */ |
| 191 | +$messages['fi'] = array( |
| 192 | + 'push-add-target' => 'Lisää kohde', |
| 193 | +); |
| 194 | + |
| 195 | +/** Upper Sorbian (Hornjoserbsce) |
| 196 | + * @author Michawiki |
| 197 | + */ |
| 198 | +$messages['hsb'] = array( |
| 199 | + 'push-add-target' => 'Cil přidać', |
| 200 | + 'push-import-revision-comment' => 'Posledni komentar: $1', |
| 201 | + 'push-remote-pages' => 'Zdalene strony', |
| 202 | + 'push-remote-page-link' => '$1 w $2', |
| 203 | + 'push-remote-page-link-full' => 'Stronu $1 na $2 sej wobhladać', |
| 204 | + 'push-targets-total' => '{{PLURAL:$1|Je $1 strona|Stej $1 stronje|Su $1 strony|Je $1 stronow}}.', |
| 205 | + 'push-tab-inc-templates' => 'Předłohi zapřijeć', |
| 206 | + 'push-tab-used-templates' => '({{PLURAL:$2|Wužita předłoha|Wužitej předłoze|Wužite předłohi|Wužite předłohi}}: $1)', |
| 207 | + 'push-tab-no-used-templates' => '(Na tutej stronje so žane přełohi wužiwaja.)', |
| 208 | + 'push-special-target-is' => 'Cilowy wiki: $1', |
| 209 | + 'push-special-select-targets' => 'Cilowe wikije:', |
| 210 | +); |
| 211 | + |
| 212 | +/** Interlingua (Interlingua) |
| 213 | + * @author McDutchie |
| 214 | + */ |
| 215 | +$messages['ia'] = array( |
| 216 | + 'push-desc' => 'Extension simple pro transferer contento a altere wikis', |
| 217 | + 'right-push' => 'Autorisation a usar le functionalitate de transferimento.', |
| 218 | + 'right-bulkpush' => 'Autorisation a usar le functionalitate de transferimento in massa (i.e. Special:Push).', |
| 219 | + 'right-pushadmin' => 'Autorisation a modificar destinationes e configurationes de transferimento.', |
| 220 | + 'push-err-captacha' => 'Non poteva transferer a $1 a causa de un problema con le "captcha".', |
| 221 | + 'push-err-captcha-page' => 'Non poteva transferer le pagina $1 a tote le destinationes proque un "captcha" esseva incontrate.', |
| 222 | + 'push-err-authentication' => 'Authentication a $1 ha fallite. $2', |
| 223 | + 'push-tab-text' => 'Transferer', |
| 224 | + 'push-button-text' => 'Transferer', |
| 225 | + 'push-tab-desc' => 'Iste scheda permitte transferer le version actual de iste pagina a un o plus altere wikis.', |
| 226 | + 'push-button-pushing' => 'Transferimento in curso', |
| 227 | + 'push-button-completed' => 'Transferimento complete', |
| 228 | + 'push-button-failed' => 'Transferimento fallite', |
| 229 | + 'push-tab-title' => 'Transfere $1', |
| 230 | + 'push-targets' => 'Destinationes de transferimento', |
| 231 | + 'push-add-target' => 'Adder destination', |
| 232 | + 'push-import-revision-message' => 'Transferite ex $1 per $2. $3', |
| 233 | + 'push-import-revision-comment' => 'Ultime commento: $1', |
| 234 | + 'push-tab-no-targets' => 'Il non ha destinationes de transferimento. Per favor adde alcunes in tu file LocalSettings.php.', |
| 235 | + 'push-tab-push-to' => 'Transferer a $1', |
| 236 | + 'push-remote-pages' => 'Paginas remote', |
| 237 | + 'push-remote-page-link' => '$1 in $2', |
| 238 | + 'push-remote-page-link-full' => 'Vider $1 in $2', |
| 239 | + 'push-targets-total' => 'Il ha un total de $1 {{PLURAL:$1|destination|destinationes}}.', |
| 240 | + 'push-button-all' => 'Transferer totes', |
| 241 | + 'push-tab-last-edit' => 'Ultime modification per $1 le $2 a $3.', |
| 242 | + 'push-tab-not-created' => 'Iste pagina non existe ancora.', |
| 243 | + 'push-tab-push-options' => 'Optiones de transferimento:', |
| 244 | + 'push-tab-inc-templates' => 'Includer patronos', |
| 245 | + 'push-tab-used-templates' => '({{PLURAL:$2|Patrono|Patronos}} usate: $1)', |
| 246 | + 'push-tab-no-used-templates' => '(Nulle patrono es usate in iste pagina.)', |
| 247 | + 'special-push' => 'Transferer paginas', |
| 248 | + 'push-special-description' => 'Iste pagina permitte transferer le contento de un o plus paginas a un o plus wikis MediaWiki. |
| 249 | + |
| 250 | +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.', |
| 251 | + 'push-special-pushing-desc' => 'Transfere $2 {{PLURAL:$2|pagina|paginas}} a $1...', |
| 252 | + 'push-special-button-text' => 'Transferer paginas', |
| 253 | + 'push-special-target-is' => 'Wiki de destination: $1', |
| 254 | + 'push-special-select-targets' => 'Wikis de destination:', |
| 255 | + 'push-special-item-pushing' => '$1: Transferimento in curso', |
| 256 | + 'push-special-item-completed' => '$1: Transferimento complete', |
| 257 | + 'push-special-item-failed' => '$1: Transferimento fallite: $2', |
| 258 | + 'push-special-push-done' => 'Transferimento complete', |
| 259 | + 'push-special-err-token-failed' => 'Non poteva obtener un indicio de modification in le wiki de destination.', |
| 260 | + 'push-special-err-pageget-failed' => 'Non poteva obtener le contento del pagina local.', |
| 261 | + 'push-special-err-push-failed' => 'Le wiki de destination refusava le pagina transferite.', |
| 262 | +); |
| 263 | + |
| 264 | +/** Indonesian (Bahasa Indonesia) |
| 265 | + * @author IvanLanin |
| 266 | + */ |
| 267 | +$messages['id'] = array( |
| 268 | + 'push-desc' => 'Ekstensi ringan untuk mendorong konten ke wiki lainnya', |
| 269 | + 'right-push' => 'Otorisasi untuk menggunakan fungsi dorong.', |
| 270 | + 'right-bulkpush' => 'Otorisasi untuk menggunakan fungsi dorong massal (Special:Push).', |
| 271 | + 'right-pushadmin' => 'Otorisasi untuk memodifikasi target dan pengaturan dorong.', |
| 272 | + 'push-err-captacha' => 'Tidak dapat mendorong ke $1 karena captcha.', |
| 273 | + 'push-err-captcha-page' => 'Tidak dapat mendorong halaman $1 ke semua target karena captcha.', |
| 274 | + 'push-err-authentication' => 'Otentikasi pada $1 gagal. $2', |
| 275 | + 'push-tab-text' => 'Dorong', |
| 276 | + 'push-button-text' => 'Dorong', |
| 277 | + 'push-tab-desc' => 'Tab ini mengizinkan Anda untuk mendorong revisi terbaru halaman ini ke satu atau lebih wiki lain.', |
| 278 | + 'push-button-pushing' => 'Mendorong', |
| 279 | + 'push-button-completed' => 'Pendorongan selesai', |
| 280 | + 'push-button-failed' => 'Pendorongan gagal', |
| 281 | + 'push-tab-title' => 'Mendorong $1', |
| 282 | + 'push-targets' => 'Target pendorongan', |
| 283 | + 'push-add-target' => 'Tambahkan target', |
| 284 | + 'push-import-revision-message' => 'Didorong dari $1 oleh $2. $3', |
| 285 | + 'push-import-revision-comment' => 'Komentar terakhir: $1', |
| 286 | + 'push-tab-no-targets' => 'Tidak ada target untuk pendorongan. Harap tambahkan beberapa berkas ke LocalSettings.php Anda.', |
| 287 | + 'push-tab-push-to' => 'Dorong ke $1', |
| 288 | + 'push-remote-pages' => 'Halaman luar', |
| 289 | + 'push-remote-page-link' => '$1 pada $2', |
| 290 | + 'push-remote-page-link-full' => 'Lihat $1 pada $2', |
| 291 | + 'push-targets-total' => 'Total ada $1 {{PLURAL:$1|target|target}}.', |
| 292 | + 'push-button-all' => 'Dorong semua', |
| 293 | + 'push-tab-last-edit' => 'Suntingan terakhir oleh $1 pada $2 $3.', |
| 294 | + 'push-tab-not-created' => 'Halaman ini belum ada.', |
| 295 | + 'push-tab-push-options' => 'Pilihan dorongan:', |
| 296 | + 'push-tab-inc-templates' => 'Sertakan templat', |
| 297 | + 'push-tab-used-templates' => '({{PLURAL:$2|Templat|Templat}} yang digunakan: $1)', |
| 298 | + 'push-tab-no-used-templates' => '(Tidak ada templat yang digunakan pada halaman ini.)', |
| 299 | + 'special-push' => 'Dorong halaman', |
| 300 | + 'push-special-description' => 'Halaman ini memungkinkan Anda untuk mendorong satu atau lebih halaman ke satu atau lebih wiki MediaWiki. |
| 301 | + |
| 302 | +Untuk mendorong halaman, masukkan judul dalam kotak teks di bawah ini, satu judul per baris, dan tekan dorong semua. Proses ini dapat memakan waktu cukup lama.', |
| 303 | + 'push-special-pushing-desc' => 'Mendorong $2 {{PLURAL:$2|halaman|halaman}} ke $1...', |
| 304 | + 'push-special-button-text' => 'Dorong halaman', |
| 305 | + 'push-special-target-is' => 'Wiki target: $1', |
| 306 | + 'push-special-select-targets' => 'Wiki target:', |
| 307 | + 'push-special-item-pushing' => '$1: Mendorong', |
| 308 | + 'push-special-item-completed' => '$1: Pendorongan selesai', |
| 309 | + 'push-special-item-failed' => '$1: Pendorongan gagal: $2', |
| 310 | + 'push-special-push-done' => 'Pendorongan selesai', |
| 311 | + 'push-special-err-token-failed' => 'Tidak dapat memperoleh token sunting pada wiki target.', |
| 312 | + 'push-special-err-pageget-failed' => 'Tidak dapat memperoleh konten halaman lokal.', |
| 313 | + 'push-special-err-push-failed' => 'Wiki target menolak laman yang didorong.', |
| 314 | +); |
| 315 | + |
| 316 | +/** Luxembourgish (Lëtzebuergesch) |
| 317 | + * @author Robby |
| 318 | + */ |
| 319 | +$messages['lb'] = array( |
| 320 | + 'push-desc' => 'Erweiderung déi en einfachen Transfert (Push) vun Inhalt op aner Wikien erméiglecht', |
| 321 | + 'right-push' => "Autorisatioun fir d'Push-Fonctionalitéit ze benotzen", |
| 322 | + 'right-bulkpush' => 'Autorisatioun fir méi Säite mateneen per Push an aner Wikien ze transferéieren', |
| 323 | + 'right-pushadmin' => "Autorisatioun fir d'Zil an d'Astellungen vun der Push-Fonctionalitéit z'änneren.", |
| 324 | + 'push-err-captacha' => 'Push op $1 konnt wéint dem Captcha net gemaach ginn.', |
| 325 | + 'push-button-completed' => 'Push ofgeschloss', |
| 326 | + 'push-import-revision-comment' => 'Lescht Bemierkung: $1', |
| 327 | + 'push-remote-page-link' => '$1 op $2', |
| 328 | + 'push-remote-page-link-full' => '$1 op $2 weisen', |
| 329 | + 'push-button-all' => 'All pushen', |
| 330 | + 'push-tab-last-edit' => 'Lescht Ännerung vum $1 de(n) $2 ëm $3 Auer.', |
| 331 | + 'push-tab-not-created' => 'Dës Säit gëtt et nach net', |
| 332 | + 'special-push' => 'Säite pushen', |
| 333 | + 'push-special-button-text' => 'Säite pushen', |
| 334 | + 'push-special-select-targets' => 'Zielwikien:', |
| 335 | + 'push-special-item-pushing' => '$1: Pushen', |
| 336 | + 'push-special-push-done' => 'Push ofgeschloss', |
| 337 | +); |
| 338 | + |
| 339 | +/** Macedonian (Македонски) |
| 340 | + * @author Bjankuloski06 |
| 341 | + */ |
| 342 | +$messages['mk'] = array( |
| 343 | + 'push-desc' => 'Мал додаток за пренесување на содржини од едно на други викија', |
| 344 | + 'right-push' => 'Потврда на сметка за да работи функцијата за пренесување.', |
| 345 | + 'right-bulkpush' => 'Потврда на сметка за да работи функцијата за групно пренесување (т.е. Special:Push).', |
| 346 | + 'right-pushadmin' => 'Потврда на сметка за измена на одредниците и поставките за пренесување.', |
| 347 | + 'push-err-captacha' => 'Не можев да го пренесам $1 поради Captcha.', |
| 348 | + 'push-err-captcha-page' => 'Не можев да ја пренесам страницата $1 на сите одредници заради Captcha.', |
| 349 | + 'push-err-authentication' => 'Потврдувањето на $1 не успеа. $2', |
| 350 | + 'push-tab-text' => 'Пренеси', |
| 351 | + 'push-button-text' => 'Пренеси', |
| 352 | + 'push-tab-desc' => 'Ова јазиче ви овозможува да ја пренесете тековната ревизија на страницава на едно или повеќе викија', |
| 353 | + 'push-button-pushing' => 'Пренесувам', |
| 354 | + 'push-button-pushing-files' => 'Пренесувам податотеки', |
| 355 | + 'push-button-completed' => 'Преносот заврши', |
| 356 | + 'push-button-failed' => 'Преносот не успеа', |
| 357 | + 'push-tab-title' => 'Пренесување на $1', |
| 358 | + 'push-targets' => 'Одредници за преносот', |
| 359 | + 'push-add-target' => 'Додај одредница', |
| 360 | + 'push-import-revision-message' => 'Пренесено од $1. Пренел: $2. $3', |
| 361 | + 'push-import-revision-comment' => 'Последен коментар: $1', |
| 362 | + 'push-tab-no-targets' => 'Нема одредници во кои би се извршил преносот. Додајте места во вашата податотека LocalSettings.php.', |
| 363 | + 'push-tab-push-to' => 'Пренеси во $1', |
| 364 | + 'push-remote-pages' => 'Далечински страници', |
| 365 | + 'push-remote-page-link' => '$1 на $2', |
| 366 | + 'push-remote-page-link-full' => 'Преглед на $1 на $2', |
| 367 | + 'push-targets-total' => 'Има вкупно $1 {{PLURAL:$1|одредница|одредници}}.', |
| 368 | + 'push-button-all' => 'Пренеси сè', |
| 369 | + 'push-tab-last-edit' => 'Последна измена од $1 на $2 во $3 ч.', |
| 370 | + 'push-tab-not-created' => 'Оваа страница сè уште не постои.', |
| 371 | + 'push-tab-push-options' => 'Поставки за преносот:', |
| 372 | + 'push-tab-inc-templates' => 'Вклучи шаблони', |
| 373 | + 'push-tab-used-templates' => '({{PLURAL:$2|Шаблон|Шаблони}} во употреба: $1)', |
| 374 | + 'push-tab-no-used-templates' => '(На страницава не се користат шаблони.)', |
| 375 | + 'push-tab-inc-files' => 'Вклучи податотеки', |
| 376 | + 'special-push' => 'Пренесување страници', |
| 377 | + 'push-special-description' => 'Оваа страница ви овозможува да пренесете содржини од една или повеќе страници од едно вики во едно или повеќе викија што работат на МедијаВики. |
| 378 | + |
| 379 | +За да пренесете, внесете ги насловите во полето подолу, по едно во секој ред, па стиснете на „Пренеси сè“. Ова може да потрае.', |
| 380 | + 'push-special-pushing-desc' => 'Пренесувам $2 {{PLURAL:$2|страница|страници}} во $1...', |
| 381 | + 'push-special-button-text' => 'Пренеси', |
| 382 | + 'push-special-target-is' => 'Целно вики: $1', |
| 383 | + 'push-special-select-targets' => 'Целни викија:', |
| 384 | + 'push-special-item-pushing' => '$1: Преместување', |
| 385 | + 'push-special-item-completed' => '$1: Преносот заврши', |
| 386 | + 'push-special-item-failed' => '$1: Преносот не успеа: $2', |
| 387 | + 'push-special-push-done' => 'Преносот заврши', |
| 388 | + 'push-special-err-token-failed' => 'Не можев да го добијам жетонот на уредувањето на целното вики.', |
| 389 | + 'push-special-err-pageget-failed' => 'Не можев да ја добијам содржината на локалната страница.', |
| 390 | + 'push-special-err-push-failed' => 'Целното вики ја одби пренесената страница.', |
| 391 | +); |
| 392 | + |
| 393 | +/** Dutch (Nederlands) |
| 394 | + * @author Siebrand |
| 395 | + */ |
| 396 | +$messages['nl'] = array( |
| 397 | + 'push-desc' => "Lichtgewichtuitbreiding om inhoud naar andere wiki's te sturen", |
| 398 | + 'right-push' => "Mag inhoud naar andere wiki's versturen.", |
| 399 | + 'right-bulkpush' => "Mag en masse inhoud naar andere wiki's versturen.", |
| 400 | + 'right-pushadmin' => "Mag doelwiki's en instellingen voor het versturen van inhoud aanpassen.", |
| 401 | + 'push-err-captacha' => 'Het was niet mogelijk inhoud te verzenden naar $1 omdat de andere wiki een captchaoplossing heeft gevraagd.', |
| 402 | + 'push-err-captcha-page' => "Het was niet mogelijk de pagina $1 naar alle doelwiki's te verzenden omdat er om een captchaoplossing is gevraagd.", |
| 403 | + 'push-err-authentication' => 'Het aanmelden bij $1 is mislukt. $2', |
| 404 | + 'push-tab-text' => 'Verzenden', |
| 405 | + 'push-button-text' => 'Verzenden', |
| 406 | + 'push-tab-desc' => "Via dit tabblad kunt u de inhoud van de huidige versie van deze pagina naar een of meer andere wiki's verzenden.", |
| 407 | + 'push-button-pushing' => 'Bezig met verzenden', |
| 408 | + 'push-button-completed' => 'Het verzenden is voltooid', |
| 409 | + 'push-button-failed' => 'Het verzenden is mislukt', |
| 410 | + 'push-tab-title' => 'Bezig met het verzenden van $1', |
| 411 | + 'push-targets' => "Doelwiki's", |
| 412 | + 'push-add-target' => 'Doelwiki toevoegen', |
| 413 | + 'push-import-revision-message' => 'Verzonden vanuit $1 door $2. $3', |
| 414 | + 'push-import-revision-comment' => 'Laatste opmerking: $1', |
| 415 | + 'push-tab-no-targets' => "Er zijn geen beschikbare doelwiki's. Voeg deze eerst toe aan uw LocalSettings.php-bestand.", |
| 416 | + 'push-tab-push-to' => 'Verzenden naar $1', |
| 417 | + 'push-remote-pages' => "Pagina's in andere wiki's", |
| 418 | + 'push-remote-page-link' => '$1 op $2', |
| 419 | + 'push-remote-page-link-full' => '$1 op $2 bekijken', |
| 420 | + 'push-targets-total' => "Er {{PLURAL:$1|is één doelwiki|zijn $1 doelwiki's}}.", |
| 421 | + 'push-button-all' => 'Alles verzenden', |
| 422 | + 'push-tab-last-edit' => 'Laatste bewerking door $1 op $2 om $3.', |
| 423 | + 'push-tab-not-created' => 'Deze pagina bestaat nog niet.', |
| 424 | + 'push-tab-push-options' => 'Verzendinstellingen:', |
| 425 | + 'push-tab-inc-templates' => 'Sjablonen ook verzenden', |
| 426 | + 'push-tab-used-templates' => '{{PLURAL:$2|Gebruikt sjabloon|Gebruikte sjablonen}}: $1', |
| 427 | + 'push-tab-no-used-templates' => 'Er worden geen sjablonen gebruikt op deze pagina.', |
| 428 | + 'special-push' => "Pagina's verzenden", |
| 429 | + 'push-special-description' => "Via deze pagina kunt u de inhoud van een of meer pagina's naar een of meer MediaWiki-wiki's verzenden. |
| 430 | + |
| 431 | +Voer paginanamen in het onderstaande invoerveld in om pagina's te kunnen verzenden. |
| 432 | +Voer iedere paginanaam in op een nieuwe regel en klik op \"Alles verzenden\". |
| 433 | +Het verzenden kan enige tijd kosten.", |
| 434 | + 'push-special-pushing-desc' => "Bezig met het verzenden van {{PLURAL:$2|één pagina|$2 pagina's}} naar $1...", |
| 435 | + 'push-special-button-text' => "Pagina's verzenden", |
| 436 | + 'push-special-target-is' => 'Doelwiki: $1', |
| 437 | + 'push-special-select-targets' => "Doelwiki's:", |
| 438 | + 'push-special-item-pushing' => '$1: bezig met verzenden', |
| 439 | + 'push-special-item-completed' => '$1: het verzenden is voltooid', |
| 440 | + 'push-special-item-failed' => '$1: het verzenden is mislukt: $2', |
| 441 | + 'push-special-push-done' => 'Het verzenden is afgerond', |
| 442 | + 'push-special-err-token-failed' => 'Het was niet mogelijk een bewerkingstoken te verkrijgen van de doelwiki.', |
| 443 | + 'push-special-err-pageget-failed' => 'Het was niet mogelijk de inhoud van de lokale pagina te verkrijgen.', |
| 444 | + 'push-special-err-push-failed' => 'De doelwiki heeft de verzonden pagina niet geaccepteerd.', |
| 445 | +); |
| 446 | + |
| 447 | +/** Russian (Русский) |
| 448 | + * @author DCamer |
| 449 | + * @author Lockal |
| 450 | + */ |
| 451 | +$messages['ru'] = array( |
| 452 | + 'push-desc' => 'Небольшое расширение для помещения содержимого в другие вики', |
| 453 | + 'right-push' => 'Авторизуйтесь чтобы использовать эту функцию.', |
| 454 | + 'right-bulkpush' => 'Авторизуйтесь чтобы использовать эту объёмную функцию (например, Служебная:Push)', |
| 455 | + 'right-pushadmin' => 'Авторизуйтесь чтобы изменять настройки и направления размещения.', |
| 456 | + 'push-err-captacha' => 'Не удалось разместить на $1 из-за капчи.', |
| 457 | + 'push-tab-text' => 'Разместить', |
| 458 | + 'push-button-text' => 'Поместить', |
| 459 | + 'push-tab-desc' => 'Эта вкладка позволяет разместить текущею версию этой страницы на одну или нескольких других вики.', |
| 460 | + 'push-button-pushing' => 'Размещение', |
| 461 | + 'push-button-completed' => 'Размещение завершено', |
| 462 | + 'push-button-failed' => 'Размещение не удалось', |
| 463 | + 'push-tab-title' => 'Размещение $1', |
| 464 | + 'push-targets' => 'Направление размещения', |
| 465 | + 'push-add-target' => 'Добавить направление', |
| 466 | + 'push-import-revision-message' => 'Импортировать от $1 до $2. $3', |
| 467 | + 'push-import-revision-comment' => 'Последний комментарий: $1', |
| 468 | + 'push-tab-no-targets' => 'Отсутствует направления размещения. Пожалуйста, добавьте их в файл LocalSettings.php.', |
| 469 | + 'push-tab-push-to' => 'Размещение на $1', |
| 470 | + 'push-remote-pages' => 'Удалённые страницы', |
| 471 | + 'push-remote-page-link' => '$1 на $2', |
| 472 | + 'push-remote-page-link-full' => 'Просмотреть $1 на $2', |
| 473 | + 'push-targets-total' => 'Всего $1 {{PLURAL:$1|направление|направления}}.', |
| 474 | + 'push-button-all' => 'Разместить все', |
| 475 | + 'special-push' => 'Разместить страницы', |
| 476 | + 'push-special-description' => 'Эта страница позволяет разместить содержимое одной или нескольких страниц на одну или несколько других вики-сайтов на движке MediaWiki. |
| 477 | + |
| 478 | +Для того, чтобы разместить страницы, введите названия в текстовом поле ниже, один заголовок на строку, и нажмите «Разместить все». Это может занять некоторое время.', |
| 479 | + 'push-special-pushing-desc' => 'Размещение $2 {{PLURAL:$2|страницы|страниц}} на $1...', |
| 480 | + 'push-special-button-text' => 'Разместить страницы', |
| 481 | + 'push-special-target-is' => 'Целевой вики-сайт: $1', |
| 482 | + 'push-special-select-targets' => 'Целевые вики-сайты:', |
| 483 | + 'push-special-item-pushing' => '$1: Размещение', |
| 484 | + 'push-special-item-completed' => '$1: Размещение завершено', |
| 485 | + 'push-special-item-failed' => '$1: Размещение не удалось: $2', |
| 486 | + 'push-special-push-done' => 'Размещение завершено', |
| 487 | + 'push-special-err-token-failed' => 'Не удалось получить маркер редактирование на целевом вики-сайте.', |
| 488 | + 'push-special-err-pageget-failed' => 'Не удалось получить локальное содержимое страницы.', |
| 489 | + 'push-special-err-push-failed' => 'Целевой вики-сайт отказался разместить страницу.', |
| 490 | +); |
| 491 | + |
| 492 | +/** Telugu (తెలుగు) |
| 493 | + * @author Veeven |
| 494 | + */ |
| 495 | +$messages['te'] = array( |
| 496 | + 'push-import-revision-comment' => 'చివరి వ్యాఖ్య: $1', |
| 497 | + 'push-special-target-is' => 'లక్ష్యిత వికీ: $1', |
| 498 | + 'push-special-select-targets' => 'లక్ష్యిత వికీలు:', |
| 499 | +); |
| 500 | + |
Property changes on: tags/extensions/Push/REL_0_5/Push.i18n.php |
___________________________________________________________________ |
Added: svn:eol-style |
1 | 501 | + native |
Index: tags/extensions/Push/REL_0_5/specials/Push_Body.php |
— | — | @@ -0,0 +1,343 @@ |
| 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, $wgTitle, $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 = PushFunctions::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 | + ) . '<br />' . |
| 175 | + Html::element( 'a', array( 'href' => $wgTitle->getInternalURL() ), wfMsg( 'push-special-return' ) ) |
| 176 | + ); |
| 177 | + |
| 178 | + $wgOut->addInlineScript( |
| 179 | + 'var wgPushPages = ' . json_encode( $pages ) . ';' . |
| 180 | + 'var wgPushTargets = ' . json_encode( $targets ) . ';' . |
| 181 | + 'var wgPushWorkerCount = ' . $egPushBulkWorkers . ';' . |
| 182 | + 'var wgPushBatchSize = ' . $egPushBatchSize . ';' . |
| 183 | + 'var wgPushIncFiles = ' . ( $wgRequest->getCheck( 'files' ) ? 'true' : 'false' ) . ';' |
| 184 | + ); |
| 185 | + |
| 186 | + $this->loadJs(); |
| 187 | + } |
| 188 | + |
| 189 | + /** |
| 190 | + * @since 0.2 |
| 191 | + */ |
| 192 | + protected function displayPushInterface( $arg, $pages ) { |
| 193 | + global $wgOut, $wgUser, $wgRequest, $egPushTargets, $egPushIncTemplates, $egPushIncFiles; |
| 194 | + |
| 195 | + $wgOut->addWikiMsg( 'push-special-description' ); |
| 196 | + |
| 197 | + $form = Xml::openElement( 'form', array( 'method' => 'post', |
| 198 | + 'action' => $this->getTitle()->getLocalUrl( 'action=submit' ) ) ); |
| 199 | + $form .= Xml::inputLabel( wfMsg( 'export-addcattext' ) , 'catname', 'catname', 40 ) . ' '; |
| 200 | + $form .= Xml::submitButton( wfMsg( 'export-addcat' ), array( 'name' => 'addcat' ) ) . '<br />'; |
| 201 | + |
| 202 | + $form .= Xml::namespaceSelector( $wgRequest->getText( 'nsindex', '' ), null, 'nsindex', wfMsg( 'export-addnstext' ) ) . ' '; |
| 203 | + $form .= Xml::submitButton( wfMsg( 'export-addns' ), array( 'name' => 'addns' ) ) . '<br />'; |
| 204 | + |
| 205 | + $form .= Xml::element( 'textarea', array( 'name' => 'pages', 'cols' => 40, 'rows' => 10 ), $pages, false ); |
| 206 | + $form .= '<br />'; |
| 207 | + |
| 208 | + $form .= Xml::checkLabel( |
| 209 | + wfMsg( 'export-templates' ), |
| 210 | + 'templates', |
| 211 | + 'wpPushTemplates', |
| 212 | + $wgRequest->wasPosted() ? $wgRequest->getCheck( 'templates' ) : $egPushIncTemplates |
| 213 | + ) . '<br />'; |
| 214 | + |
| 215 | + if ( $wgUser->isAllowed( 'filepush' ) ) { |
| 216 | + $form .= Xml::checkLabel( |
| 217 | + wfMsg( 'push-special-inc-files' ), |
| 218 | + 'files', |
| 219 | + 'wpPushFiles', |
| 220 | + $wgRequest->wasPosted() ? $wgRequest->getCheck( 'files' ) : $egPushIncFiles |
| 221 | + ) . '<br />'; |
| 222 | + } |
| 223 | + |
| 224 | + if ( count( $egPushTargets ) == 1 ) { |
| 225 | + $names = array_keys( $egPushTargets ); |
| 226 | + $form .= '<b>' . htmlspecialchars( wfMsgExt( 'push-special-target-is', 'parsemag', $names[0] ) ) . '</b><br />'; |
| 227 | + } |
| 228 | + else { |
| 229 | + $form .= '<b>' . htmlspecialchars( wfMsg( 'push-special-select-targets' ) ) . '</b><br />'; |
| 230 | + |
| 231 | + foreach ( $egPushTargets as $targetName => $targetUrl ) { |
| 232 | + $checkName = str_replace( ' ', '_', $targetName ); |
| 233 | + $checked = $wgRequest->wasPosted() ? $wgRequest->getCheck( $checkName ) : true; |
| 234 | + $form .= Xml::checkLabel( $targetName, $checkName, $targetName, $checked ) . '<br />'; |
| 235 | + } |
| 236 | + } |
| 237 | + |
| 238 | + $form .= Xml::submitButton( wfMsg( 'push-special-button-text' ), array( 'style' => 'width: 125px; height: 30px' ) ); |
| 239 | + $form .= Xml::closeElement( 'form' ); |
| 240 | + |
| 241 | + $wgOut->addHTML( $form ); |
| 242 | + } |
| 243 | + |
| 244 | + /** |
| 245 | + * Returns all pages for a category (up to 5000). |
| 246 | + * |
| 247 | + * @since 0.2 |
| 248 | + * |
| 249 | + * @param Title $title |
| 250 | + * |
| 251 | + * @return array |
| 252 | + */ |
| 253 | + protected function getPagesFromCategory( Title $title ) { |
| 254 | + global $wgContLang; |
| 255 | + |
| 256 | + $name = $title->getDBkey(); |
| 257 | + |
| 258 | + $dbr = wfGetDB( DB_SLAVE ); |
| 259 | + $res = $dbr->select( |
| 260 | + array( 'page', 'categorylinks' ), |
| 261 | + array( 'page_namespace', 'page_title' ), |
| 262 | + array( 'cl_from=page_id', 'cl_to' => $name ), |
| 263 | + __METHOD__, |
| 264 | + array( 'LIMIT' => '5000' ) |
| 265 | + ); |
| 266 | + |
| 267 | + $pages = array(); |
| 268 | + |
| 269 | + foreach ( $res as $row ) { |
| 270 | + $n = $row->page_title; |
| 271 | + if ($row->page_namespace) { |
| 272 | + $ns = $wgContLang->getNsText( $row->page_namespace ); |
| 273 | + $n = $ns . ':' . $n; |
| 274 | + } |
| 275 | + |
| 276 | + $pages[] = $n; |
| 277 | + } |
| 278 | + return $pages; |
| 279 | + } |
| 280 | + |
| 281 | + /** |
| 282 | + * Returns all pages for a namespace (up to 5000). |
| 283 | + * |
| 284 | + * @since 0.2 |
| 285 | + * |
| 286 | + * @param integer $nsindex |
| 287 | + * |
| 288 | + * @return array |
| 289 | + */ |
| 290 | + protected function getPagesFromNamespace( $nsindex ) { |
| 291 | + global $wgContLang; |
| 292 | + |
| 293 | + $dbr = wfGetDB( DB_SLAVE ); |
| 294 | + $res = $dbr->select( |
| 295 | + 'page', |
| 296 | + array( 'page_namespace', 'page_title' ), |
| 297 | + array( 'page_namespace' => $nsindex ), |
| 298 | + __METHOD__, |
| 299 | + array( 'LIMIT' => '5000' ) |
| 300 | + ); |
| 301 | + |
| 302 | + $pages = array(); |
| 303 | + |
| 304 | + foreach ( $res as $row ) { |
| 305 | + $n = $row->page_title; |
| 306 | + |
| 307 | + if ( $row->page_namespace ) { |
| 308 | + $ns = $wgContLang->getNsText( $row->page_namespace ); |
| 309 | + $n = $ns . ':' . $n; |
| 310 | + } |
| 311 | + |
| 312 | + $pages[] = $n; |
| 313 | + } |
| 314 | + return $pages; |
| 315 | + } |
| 316 | + |
| 317 | + /** |
| 318 | + * Loads the needed JavaScript. |
| 319 | + * Takes care of non-RL compatibility. |
| 320 | + * |
| 321 | + * @since 0.2 |
| 322 | + */ |
| 323 | + protected static function loadJs() { |
| 324 | + global $wgOut; |
| 325 | + |
| 326 | + // For backward compatibility with MW < 1.17. |
| 327 | + if ( is_callable( array( $wgOut, 'addModules' ) ) ) { |
| 328 | + $wgOut->addModules( 'ext.push.special' ); |
| 329 | + } |
| 330 | + else { |
| 331 | + global $egPushScriptPath; |
| 332 | + |
| 333 | + PushFunctions::addJSLocalisation(); |
| 334 | + |
| 335 | + $wgOut->includeJQuery(); |
| 336 | + |
| 337 | + $wgOut->addHeadItem( |
| 338 | + 'ext.push.special', |
| 339 | + Html::linkedScript( $egPushScriptPath . '/specials/ext.push.special.js' ) |
| 340 | + ); |
| 341 | + } |
| 342 | + } |
| 343 | + |
| 344 | +} |
\ No newline at end of file |
Property changes on: tags/extensions/Push/REL_0_5/specials/Push_Body.php |
___________________________________________________________________ |
Added: svn:eol-style |
1 | 345 | + native |
Index: tags/extensions/Push/REL_0_5/specials/ext.push.special.js |
— | — | @@ -0,0 +1,222 @@ |
| 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 | + var pushedFiles = []; |
| 38 | + |
| 39 | + for ( i = requestAmount; i > 0; i-- ) { |
| 40 | + initiateNextPush(); |
| 41 | + } |
| 42 | + |
| 43 | + function initiateNextPush() { |
| 44 | + var page = pages.pop(); |
| 45 | + |
| 46 | + if ( page ) { |
| 47 | + startPush( page, 0, null ); |
| 48 | + } |
| 49 | + else if ( !--requestAmount ) { |
| 50 | + showCompletion(); |
| 51 | + } |
| 52 | + } |
| 53 | + |
| 54 | + function startPush( pageName, targetOffset, listItem ) { |
| 55 | + if ( targetOffset == 0 ) { |
| 56 | + var listItem = $( '<li />' ); |
| 57 | + listItem.text( mediaWiki.msg( 'push-special-item-pushing', pageName ) ); |
| 58 | + |
| 59 | + var box = $('#pushResultDiv'); |
| 60 | + var innerBox = $('#pushResultDiv > .innerResultBox'); |
| 61 | + var atBottom = Math.abs(innerBox.offset().top) + box.height() + box.offset().top >= innerBox.outerHeight(); |
| 62 | + |
| 63 | + resultList.append( listItem ); |
| 64 | + |
| 65 | + if ( atBottom ) { |
| 66 | + box.attr( {'scrollTop': box.attr( 'scrollHeight' )} ); |
| 67 | + } |
| 68 | + } |
| 69 | + |
| 70 | + var currentBatchLimit = Math.min( targetOffset + batchSize, targets.length ); |
| 71 | + var currentBatchStart = targetOffset; |
| 72 | + |
| 73 | + if ( targetOffset < targets.length ) { |
| 74 | + listItem.text( listItem.text() + '...' ); |
| 75 | + |
| 76 | + targetOffset = currentBatchLimit; |
| 77 | + |
| 78 | + $.getJSON( |
| 79 | + wgScriptPath + '/api.php', |
| 80 | + { |
| 81 | + 'action': 'push', |
| 82 | + 'format': 'json', |
| 83 | + 'page': pageName, |
| 84 | + 'targets': targets.slice( currentBatchStart, currentBatchLimit ).join( '|' ) |
| 85 | + }, |
| 86 | + function( data ) { |
| 87 | + if ( data.error ) { |
| 88 | + handleError( listItem, pageName, data.error ); |
| 89 | + } |
| 90 | + else if ( data.length > 0 && data[0].edit && data[0].edit.captcha ) { |
| 91 | + handleError( listItem, pageName, { info: mediaWiki.msg( 'push-err-captcha-page', pageName ) } ); |
| 92 | + } |
| 93 | + else { |
| 94 | + startPush( pageName, targetOffset, listItem ); |
| 95 | + } |
| 96 | + } |
| 97 | + ); |
| 98 | + } |
| 99 | + else { |
| 100 | + if ( window.wgPushIncFiles ) { |
| 101 | + getIncludedImagesAndInitPush( pageName, listItem ); |
| 102 | + } |
| 103 | + else { |
| 104 | + completeItem( pageName, listItem ); |
| 105 | + } |
| 106 | + } |
| 107 | + } |
| 108 | + |
| 109 | + function getIncludedImagesAndInitPush( pageName, listItem ) { |
| 110 | + listItem.text( mediaWiki.msg( 'push-special-obtaining-fileinfo', pageName ) ); |
| 111 | + |
| 112 | + $.getJSON( |
| 113 | + wgScriptPath + '/api.php', |
| 114 | + { |
| 115 | + 'action': 'query', |
| 116 | + 'prop': 'images', |
| 117 | + 'format': 'json', |
| 118 | + 'titles': pageName, |
| 119 | + }, |
| 120 | + function( data ) { |
| 121 | + if ( data.query ) { |
| 122 | + var images = []; |
| 123 | + |
| 124 | + for ( page in data.query.pages ) { |
| 125 | + if ( data.query.pages[page].images ) { |
| 126 | + for ( var i = data.query.pages[page].images.length - 1; i >= 0; i-- ) { |
| 127 | + if ( $.inArray( data.query.pages[page].images[i].title, pushedFiles ) == -1 ) { |
| 128 | + pushedFiles.push( data.query.pages[page].images[i].title ); |
| 129 | + images.push( data.query.pages[page].images[i].title ); |
| 130 | + } |
| 131 | + } |
| 132 | + } |
| 133 | + } |
| 134 | + |
| 135 | + if ( images.length > 0 ) { |
| 136 | + var currentFile = images.pop(); |
| 137 | + startFilePush( pageName, images, 0, listItem, currentFile ); |
| 138 | + } |
| 139 | + else { |
| 140 | + completeItem( pageName, listItem ); |
| 141 | + } |
| 142 | + } |
| 143 | + else { |
| 144 | + handleError( pageName, { info: mediaWiki.msg( 'push-special-err-imginfo-failed' ) } ); |
| 145 | + } |
| 146 | + } |
| 147 | + ); |
| 148 | + } |
| 149 | + |
| 150 | + function startFilePush( pageName, images, targetOffset, listItem, fileName ) { |
| 151 | + if ( targetOffset == 0 ) { |
| 152 | + listItem.text( mediaWiki.msg( 'push-special-pushing-file', pageName, fileName ) ); |
| 153 | + } |
| 154 | + else { |
| 155 | + listItem.text( listItem.text() + '...' ); |
| 156 | + } |
| 157 | + |
| 158 | + var currentBatchLimit = Math.min( targetOffset + batchSize, targets.length ); |
| 159 | + var currentBatchStart = targetOffset; |
| 160 | + |
| 161 | + if ( targetOffset < targets.length ) { |
| 162 | + listItem.text( listItem.text() + '...' ); |
| 163 | + |
| 164 | + targetOffset = currentBatchLimit; |
| 165 | + |
| 166 | + $.getJSON( |
| 167 | + wgScriptPath + '/api.php', |
| 168 | + { |
| 169 | + 'action': 'pushimages', |
| 170 | + 'format': 'json', |
| 171 | + 'images': fileName, |
| 172 | + 'targets': targets.slice( currentBatchStart, currentBatchLimit ).join( '|' ) |
| 173 | + }, |
| 174 | + function( data ) { |
| 175 | + var fail = false; |
| 176 | + |
| 177 | + for ( i in data ) { |
| 178 | + if ( data[i].error ) { |
| 179 | + handleError( listItem, pageName, { info: mediaWiki.msg( 'push-tab-err-filepush', data[i].error.info ) } ); |
| 180 | + fail = true; |
| 181 | + break; |
| 182 | + } |
| 183 | + else if ( !data[i].upload ) { |
| 184 | + handleError( listItem, pageName, { info: mediaWiki.msg( 'push-tab-err-filepush-unknown' ) } ); |
| 185 | + fail = true; |
| 186 | + break; |
| 187 | + } |
| 188 | + } |
| 189 | + |
| 190 | + if ( !fail ) { |
| 191 | + startFilePush( pageName, images, targetOffset, listItem, fileName ); |
| 192 | + } |
| 193 | + } |
| 194 | + ); |
| 195 | + } |
| 196 | + else { |
| 197 | + if ( images.length > 0 ) { |
| 198 | + var currentFile = images.pop(); |
| 199 | + startFilePush( pageName, images, 0, listItem, currentFile ); |
| 200 | + } |
| 201 | + else { |
| 202 | + completeItem( pageName, listItem ); |
| 203 | + } |
| 204 | + } |
| 205 | + } |
| 206 | + |
| 207 | + function completeItem( pageName, listItem ) { |
| 208 | + listItem.text( mediaWiki.msg( 'push-special-item-completed', pageName ) ); |
| 209 | + listItem.css( 'color', 'darkgray' ); |
| 210 | + initiateNextPush(); |
| 211 | + } |
| 212 | + |
| 213 | + function handleError( listItem, pageName, error ) { |
| 214 | + listItem.text( mediaWiki.msg( 'push-special-item-failed', pageName, error.info ) ); |
| 215 | + listItem.css( 'color', 'darkred' ); |
| 216 | + initiateNextPush(); |
| 217 | + } |
| 218 | + |
| 219 | + function showCompletion() { |
| 220 | + resultList.append( $( '<li />' ).append( $( '<b />' ).text( mediaWiki.msg( 'push-special-push-done' ) ) ) ); |
| 221 | + } |
| 222 | + |
| 223 | +} ); })(jQuery); |
\ No newline at end of file |
Property changes on: tags/extensions/Push/REL_0_5/specials/ext.push.special.js |
___________________________________________________________________ |
Added: svn:eol-style |
1 | 224 | + native |
Index: tags/extensions/Push/REL_0_5/Push.php |
— | — | @@ -0,0 +1,117 @@ |
| 2 | +<?php |
| 3 | + |
| 4 | +/** |
| 5 | + * Initialization file for the Push extension. |
| 6 | + * |
| 7 | + * Documentation: http://www.mediawiki.org/wiki/Extension:Push |
| 8 | + * Support http://www.mediawiki.org/wiki/Extension_talk:Push |
| 9 | + * Source code: http://svn.wikimedia.org/viewvc/mediawiki/trunk/extensions/Push |
| 10 | + * |
| 11 | + * @file Push.php |
| 12 | + * @ingroup Push |
| 13 | + * |
| 14 | + * @licence GNU GPL v3 |
| 15 | + * |
| 16 | + * @author Jeroen De Dauw < jeroendedauw@gmail.com > |
| 17 | + */ |
| 18 | + |
| 19 | +/** |
| 20 | + * This documenation group collects source code files belonging to Push. |
| 21 | + * |
| 22 | + * @defgroup Push Push |
| 23 | + */ |
| 24 | + |
| 25 | +if ( !defined( 'MEDIAWIKI' ) ) { |
| 26 | + die( 'Not an entry point.' ); |
| 27 | +} |
| 28 | + |
| 29 | +define( 'Push_VERSION', '0.5 rc' ); |
| 30 | + |
| 31 | +$wgExtensionCredits['other'][] = array( |
| 32 | + 'path' => __FILE__, |
| 33 | + 'name' => 'Push', |
| 34 | + 'version' => Push_VERSION, |
| 35 | + 'author' => array( |
| 36 | + '[http://www.mediawiki.org/wiki/User:Jeroen_De_Dauw Jeroen De Dauw] for [http://www.wikiworks.com WikiWorks]', |
| 37 | + ), |
| 38 | + 'url' => 'http://www.mediawiki.org/wiki/Extension:Push', |
| 39 | + 'descriptionmsg' => 'push-desc' |
| 40 | +); |
| 41 | + |
| 42 | +$useExtensionPath = version_compare( $wgVersion, '1.16', '>=' ) && isset( $wgExtensionAssetsPath ) && $wgExtensionAssetsPath; |
| 43 | +$egPushScriptPath = ( $useExtensionPath ? $wgExtensionAssetsPath : $wgScriptPath . '/extensions' ) . '/Push'; |
| 44 | +$egPushIP = dirname( __FILE__ ); |
| 45 | +unset( $useExtensionPath ); |
| 46 | + |
| 47 | +$wgExtensionMessagesFiles['Push'] = $egPushIP . '/Push.i18n.php'; |
| 48 | +$wgExtensionAliasesFiles['Push'] = $egPushIP . '/Push.alias.php'; |
| 49 | + |
| 50 | +$wgAutoloadClasses['PushHooks'] = $egPushIP . '/Push.hooks.php'; |
| 51 | +$wgAutoloadClasses['ApiPush'] = $egPushIP . '/api/ApiPush.php'; |
| 52 | +$wgAutoloadClasses['ApiPushImages'] = $egPushIP . '/api/ApiPushImages.php'; |
| 53 | +$wgAutoloadClasses['PushTab'] = $egPushIP . '/includes/Push_Tab.php'; |
| 54 | +$wgAutoloadClasses['PushFunctions'] = $egPushIP . '/includes/Push_Functions.php'; |
| 55 | +$wgAutoloadClasses['SpecialPush'] = $egPushIP . '/specials/Push_Body.php'; |
| 56 | + |
| 57 | +$wgSpecialPages['Push'] = 'SpecialPush'; |
| 58 | +$wgSpecialPageGroups['Push'] = 'pagetools'; |
| 59 | + |
| 60 | +$wgAPIModules['push'] = 'ApiPush'; |
| 61 | +$wgAPIModules['pushimages'] = 'ApiPushImages'; |
| 62 | + |
| 63 | +$wgHooks['UnknownAction'][] = 'PushTab::onUnknownAction'; |
| 64 | +$wgHooks['SkinTemplateTabs'][] = 'PushTab::displayTab'; |
| 65 | +$wgHooks['SkinTemplateNavigation'][] = 'PushTab::displayTab2'; |
| 66 | + |
| 67 | +$wgHooks['AdminLinks'][] = 'PushHooks::addToAdminLinks'; |
| 68 | + |
| 69 | +$wgAvailableRights[] = 'push'; |
| 70 | +$wgAvailableRights[] = 'pushadmin'; |
| 71 | + |
| 72 | +$egPushJSMessages = array( |
| 73 | + 'push-button-pushing', |
| 74 | + 'push-button-completed', |
| 75 | + 'push-button-failed', |
| 76 | + 'push-import-revision-message', |
| 77 | + 'push-button-text', |
| 78 | + 'push-button-all', |
| 79 | + 'push-special-item-pushing', |
| 80 | + 'push-special-item-completed', |
| 81 | + 'push-special-item-failed', |
| 82 | + 'push-special-push-done', |
| 83 | + 'push-err-captacha', |
| 84 | + 'push-tab-last-edit', |
| 85 | + 'push-tab-not-created', |
| 86 | + 'push-err-captcha-page', |
| 87 | + 'push-button-pushing-files', |
| 88 | + 'push-special-err-imginfo-failed', |
| 89 | + 'push-special-obtaining-fileinfo', |
| 90 | + 'push-special-pushing-file', |
| 91 | + 'push-tab-err-fileinfo', |
| 92 | + 'push-tab-err-filepush', |
| 93 | + 'push-tab-err-filepush-unknown', |
| 94 | +); |
| 95 | + |
| 96 | +// For backward compatibility with MW < 1.17. |
| 97 | +if ( is_callable( array( 'OutputPage', 'addModules' ) ) ) { |
| 98 | + $moduleTemplate = array( |
| 99 | + 'localBasePath' => dirname( __FILE__ ), |
| 100 | + 'remoteBasePath' => $egPushScriptPath, |
| 101 | + 'group' => 'ext.push' |
| 102 | + ); |
| 103 | + |
| 104 | + $wgResourceModules['ext.push.tab'] = $moduleTemplate + array( |
| 105 | + 'scripts' => 'includes/ext.push.tab.js', |
| 106 | + 'dependencies' => array(), |
| 107 | + 'messages' => $egPushJSMessages |
| 108 | + ); |
| 109 | + |
| 110 | + $wgResourceModules['ext.push.special'] = $moduleTemplate + array( |
| 111 | + 'scripts' => 'specials/ext.push.special.js', |
| 112 | + 'dependencies' => array(), |
| 113 | + 'messages' => $egPushJSMessages |
| 114 | + ); |
| 115 | +} |
| 116 | + |
| 117 | +require_once 'Push_Settings.php'; |
| 118 | + |
Property changes on: tags/extensions/Push/REL_0_5/Push.php |
___________________________________________________________________ |
Added: svn:eol-style |
1 | 119 | + native |
Index: tags/extensions/Push/REL_0_5/Push_Settings.php |
— | — | @@ -0,0 +1,67 @@ |
| 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 | +# List of targets that can be pushed to. |
| 23 | +# The array keys are the target names, and the values are the target urls (path to api.php without the '/api.php' part) |
| 24 | +# Example: $egPushTargets['English Wikipedia'] = 'http://en.wikipedia.org/w'; |
| 25 | +$egPushTargets = array(); |
| 26 | + |
| 27 | +# Push rights. |
| 28 | +//$wgGroupPermissions['*']['push'] = true; |
| 29 | +$wgGroupPermissions['autoconfirmed']['push'] = true; |
| 30 | +$wgGroupPermissions['sysop']['push'] = true; |
| 31 | +$wgGroupPermissions['autoconfirmed']['bulkpush'] = true; |
| 32 | +$wgGroupPermissions['sysop']['bulkpush'] = true; |
| 33 | +$wgGroupPermissions['autoconfirmed']['filepush'] = true; |
| 34 | +$wgGroupPermissions['sysop']['filepush'] = true; |
| 35 | +// $wgGroupPermissions['sysop']['pushadmin'] = true; |
| 36 | + |
| 37 | +# Show the push action as a tab (if not, it's displayed in the actions dropdown). |
| 38 | +# This only works for skins with an actions dropdown. For others push will always appear as a tab. |
| 39 | +$egPushShowTab = false; |
| 40 | + |
| 41 | +# You can choose to include templates when pushing a page. |
| 42 | +# This is the default choice. |
| 43 | +$egPushIncTemplates = false; |
| 44 | + |
| 45 | +# You can choose to push files used in a page. |
| 46 | +# This is the default choice. |
| 47 | +$egPushIncFiles = false; |
| 48 | + |
| 49 | +# Indicated if login options should be added to the push interface or not. |
| 50 | +$egPushAllowLogin = true; |
| 51 | + |
| 52 | +# Default login data. When set, the values will always be used when there is |
| 53 | +# no login interface. If there is, they will be filled in as default. |
| 54 | +$egPushLoginUser = ''; |
| 55 | +$egPushLoginPass = ''; |
| 56 | + |
| 57 | +# Default login data per target. Overrides $egPushLoginUser and $egPushLoginPass when specified. |
| 58 | +# Array keys should be the urls assigned in the $egPushTargets array. |
| 59 | +# When set, the values will always be used when there is |
| 60 | +# no login interface. If there is, they will be filled in as default. |
| 61 | +$egPushLoginUsers = array(); |
| 62 | +$egPushLoginPasswords = array(); |
| 63 | + |
| 64 | +# The amount of push 'workers' (simultanious push requests) on Special:Push. |
| 65 | +$egPushBulkWorkers = 3; |
| 66 | + |
| 67 | +# The maximum amount of targets to push a page to in one go. |
| 68 | +$egPushBatchSize = 3; |
Property changes on: tags/extensions/Push/REL_0_5/Push_Settings.php |
___________________________________________________________________ |
Added: svn:eol-style |
1 | 69 | + native |
Index: tags/extensions/Push/REL_0_5/INSTALL |
— | — | @@ -0,0 +1,94 @@ |
| 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 | +Configuration of push is done by adding simple PHP statements to your [[Manual:LocalSettings.php|LocalSettings.php]] |
| 19 | +file. These statements need to be placed AFTER the inclusion of Push. The options are listed below and their default |
| 20 | +is set in the [http://svn.wikimedia.org/viewvc/mediawiki/trunk/extensions/Push/Push_Settings.php?view=markup push |
| 21 | +settings file]. You should NOT modify the settings file, but can have a look at it to get an idea of how to use the |
| 22 | +ettings, in case the below descriptions do not suffice. |
| 23 | + |
| 24 | +=== Push targets === |
| 25 | + |
| 26 | +You can add push targets (wikis you can push content to) by adding elements to the <code>$egPushTargets</code> array. |
| 27 | +The array keys should be the names of your wikis and the values should point to the wiki root, without tailing slash. |
| 28 | +You can find your wiki root by clicking the history tab on a page, finding the '/index.php' in it, and taking |
| 29 | +everything that's left of that. Example: |
| 30 | + |
| 31 | +<source lang="php"> |
| 32 | +$egPushTargets['English Wikipedia'] = 'http://en.wikipedia.org/w'; |
| 33 | +$egPushTargets['Local MW 1.16'] = 'http://localhost/mw116'; |
| 34 | +$egPushTargets['Local MW trunk'] = 'http://localhost/phase3'; |
| 35 | +</source> |
| 36 | + |
| 37 | +By default there are no targets, which will cause the push tab to not be shown anywhere until you add at least one target. |
| 38 | + |
| 39 | +=== Rights === |
| 40 | + |
| 41 | +Push adds the following rights to MediaWiki: |
| 42 | + |
| 43 | +* push: Indicates whether you are able to use the push functionality or not. |
| 44 | +* bulkpush: Indicates whether you are able to use Special:Push or not. (as of v0.3) |
| 45 | +* filepush: Indicates whether you are able to push files or not. (as of v0.5) |
| 46 | + |
| 47 | +By default everyone has 'push', and only registered users have 'bulkpush' and 'filepush'. The later is to prevent |
| 48 | +anonymous users from easily vandalizing the target wikis. |
| 49 | + |
| 50 | +=== Tab display === |
| 51 | + |
| 52 | +When using vector like skins, you can choose to have the push tab displayed on the page itself, or in the action menu |
| 53 | +you can open by clicking the down arrow next to the visible tabs. For this you need to set the <code>$egPushShowTab</code> |
| 54 | +variable to either true or false. The default is true. |
| 55 | + |
| 56 | +=== Authentication === |
| 57 | + |
| 58 | +As of version 0.4, you can specify a username (<code>$egPushLoginUser</code>) and password (<code>$egPushLoginPass</code>) |
| 59 | +to authenticate with on the remote wikis. You can also specify login information per target wiki, which will override the |
| 60 | +global settings when set. You can do this by adding items to the <code>$egPushLoginUsers</code> and |
| 61 | +<code>$egPushLoginPasswords</code> arrays. The keys need to be the target names set in $egPushTargets. Example: |
| 62 | + |
| 63 | +<source lang="php"> |
| 64 | +$egPushLoginUsers['English Wikipedia'] = 'Jeroen De Dauw'; |
| 65 | +$egPushLoginPasswords['English Wikipedia'] = 'Awesome'; |
| 66 | +</source> |
| 67 | + |
| 68 | +If you are running wikis on localhost, pushing from a MW 1.16 install will not work, due to an issue in |
| 69 | +Cookie::validateCookieDomain. It can be fixed by replacing this method by it's MW 1.17 equivalent. |
| 70 | + |
| 71 | +=== Pushing files === |
| 72 | + |
| 73 | +As of version 0.5 of Push, you can choose to push the files used in the page you are pushing. This is done by checking |
| 74 | +'Include files' on the push interface. You can set the default check-state with the <code>$egPushIncFiles</code> setting. |
| 75 | +Keep in mind you need the 'filepush' right to use this functionality, so the checkbox won't show up when you are not |
| 76 | +logged in using the default rights. |
| 77 | + |
| 78 | +To successfully push any file, you need to have sufficient privileges '''on the target wiki''' (which probably means |
| 79 | +you'll have to authenticate), and the target wiki needs to be configured so it accepts uploads. You need to have |
| 80 | +both <code>$wgEnableUploads</code> and <code>$wgAllowCopyUploads</code> set to true, like this: |
| 81 | + |
| 82 | +<source lang="php"> |
| 83 | +$wgEnableUploads = true; |
| 84 | +$wgAllowCopyUploads = true; |
| 85 | +</source> |
| 86 | + |
| 87 | +=== Push workers === |
| 88 | + |
| 89 | +Special:Push pushes multiple pages simultaneously. By default this is limited to 3, but you can increase this by |
| 90 | +setting the value of <code>$egPushBulkWorkers</code>. Putting it to high might result in very slow or even failing requests. |
| 91 | + |
| 92 | +=== Push batch size === |
| 93 | + |
| 94 | +The maximum amount of targets to push a page to in one go. Currently only used on Special:Push. |
| 95 | +Set using <code>$egPushBatchSize</code> Defaults to 3. |
Index: tags/extensions/Push/REL_0_5/RELEASE-NOTES |
— | — | @@ -0,0 +1,42 @@ |
| 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.5 === |
| 9 | +2010-12-14 |
| 10 | + |
| 11 | +* Added support for file-pushing. |
| 12 | +* Improved push status visualization on the tab interface. |
| 13 | + |
| 14 | +=== Version 0.4 === |
| 15 | +2010-12-12 |
| 16 | + |
| 17 | +* Added option to include templates used on the page to the push to the tab interface. |
| 18 | +* Added remote authentication support to the push API module. |
| 19 | +* Added additional info about target pages to the tab interface. |
| 20 | + |
| 21 | +=== Version 0.3 === |
| 22 | +2010-12-10 |
| 23 | + |
| 24 | +* Fixed push functionality for wikis on remote domains. |
| 25 | +* Added 'bulkpush' right. |
| 26 | +* Added batch operations to Special:Push. |
| 27 | +* Added redlink support to the tab interface. |
| 28 | +* Improved error handling. |
| 29 | + |
| 30 | +=== Version 0.2 === |
| 31 | +2010-12-08 |
| 32 | + |
| 33 | +* Added Special:Push for bulk pushing. |
| 34 | +* Added AdminLinks hook. |
| 35 | + |
| 36 | +=== Version 0.1 === |
| 37 | +2010-12-08 |
| 38 | + |
| 39 | +Initial release. |
| 40 | + |
| 41 | +* Added push tab that allows pushing the page to one or more other wikis. |
| 42 | +* Added ApprovedRevs support. |
| 43 | +* Added 'push' right. |
\ No newline at end of file |
Index: tags/extensions/Push/REL_0_5/includes/Push_Tab.php |
— | — | @@ -0,0 +1,360 @@ |
| 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 | + self::displayPushList(); |
| 132 | + |
| 133 | + self::displayPushOptions(); |
| 134 | + |
| 135 | + return false; |
| 136 | + } |
| 137 | + |
| 138 | + /** |
| 139 | + * Displays a list with all targets to which can be pushed. |
| 140 | + * |
| 141 | + * @since 0.1 |
| 142 | + */ |
| 143 | + protected static function displayPushList() { |
| 144 | + global $wgOut, $egPushTargets, $wgLang; |
| 145 | + |
| 146 | + $items = array( |
| 147 | + Html::rawElement( |
| 148 | + 'tr', |
| 149 | + array(), |
| 150 | + Html::element( |
| 151 | + 'th', |
| 152 | + array( 'width' => '200px' ), |
| 153 | + wfMsg( 'push-targets' ) |
| 154 | + ) . |
| 155 | + Html::element( |
| 156 | + 'th', |
| 157 | + array( 'style' => 'min-width:400px;' ), |
| 158 | + wfMsg( 'push-remote-pages' ) |
| 159 | + ) . |
| 160 | + Html::element( |
| 161 | + 'th', |
| 162 | + array( 'width' => '125px' ), |
| 163 | + '' |
| 164 | + ) |
| 165 | + ) |
| 166 | + ); |
| 167 | + |
| 168 | + foreach ( $egPushTargets as $name => $url ) { |
| 169 | + $items[] = self::getPushItem( $name, $url ); |
| 170 | + } |
| 171 | + |
| 172 | + // If there is more then one item, display the 'push all' row. |
| 173 | + if ( count( $egPushTargets ) > 1 ) { |
| 174 | + $items[] = Html::rawElement( |
| 175 | + 'tr', |
| 176 | + array(), |
| 177 | + Html::element( |
| 178 | + 'th', |
| 179 | + array( 'colspan' => 2, 'style' => 'text-align: left' ), |
| 180 | + wfMsgExt( 'push-targets-total', 'parsemag', $wgLang->formatNum( count( $egPushTargets ) ) ) |
| 181 | + ) . |
| 182 | + Html::rawElement( |
| 183 | + 'th', |
| 184 | + array( 'width' => '125px' ), |
| 185 | + Html::element( |
| 186 | + 'button', |
| 187 | + array( |
| 188 | + 'id' => 'push-all-button', |
| 189 | + 'style' => 'width: 125px; height: 30px', |
| 190 | + ), |
| 191 | + wfMsg( 'push-button-all' ) |
| 192 | + ) |
| 193 | + ) |
| 194 | + ); |
| 195 | + } |
| 196 | + |
| 197 | + $wgOut->addHtml( |
| 198 | + Html::rawElement( |
| 199 | + 'table', |
| 200 | + array( 'class' => 'wikitable', 'width' => '50%' ), |
| 201 | + implode( "\n", $items ) |
| 202 | + ) |
| 203 | + ); |
| 204 | + } |
| 205 | + |
| 206 | + /** |
| 207 | + * Returns the HTML for a single push target. |
| 208 | + * |
| 209 | + * @since 0.1 |
| 210 | + * |
| 211 | + * @param string $name |
| 212 | + * @param string $url |
| 213 | + * |
| 214 | + * @return string |
| 215 | + */ |
| 216 | + protected static function getPushItem( $name, $url ) { |
| 217 | + global $wgTitle; |
| 218 | + |
| 219 | + static $targetId = 0; |
| 220 | + $targetId++; |
| 221 | + |
| 222 | + return Html::rawElement( |
| 223 | + 'tr', |
| 224 | + array(), |
| 225 | + Html::element( |
| 226 | + 'td', |
| 227 | + array(), |
| 228 | + $name |
| 229 | + ) . |
| 230 | + Html::rawElement( |
| 231 | + 'td', |
| 232 | + array( 'height' => '45px' ), |
| 233 | + Html::element( |
| 234 | + 'a', |
| 235 | + array( |
| 236 | + 'href' => $url . '/index.php?title=' . $wgTitle->getFullText(), |
| 237 | + 'rel' => 'nofollow', |
| 238 | + 'id' => 'targetlink' . $targetId |
| 239 | + ), |
| 240 | + wfMsgExt( 'push-remote-page-link', 'parsemag', $wgTitle->getFullText(), $name ) |
| 241 | + ) . |
| 242 | + Html::element( |
| 243 | + 'div', |
| 244 | + array( |
| 245 | + 'id' => 'targetinfo' . $targetId, |
| 246 | + 'style' => 'display:none; color:darkgray' |
| 247 | + ) |
| 248 | + ) . |
| 249 | + Html::element( |
| 250 | + 'div', |
| 251 | + array( |
| 252 | + 'id' => 'targeterrors' . $targetId, |
| 253 | + 'style' => 'display:none; color:darkred' |
| 254 | + ) |
| 255 | + ) |
| 256 | + ) . |
| 257 | + Html::rawElement( |
| 258 | + 'td', |
| 259 | + array(), |
| 260 | + Html::element( |
| 261 | + 'button', |
| 262 | + array( |
| 263 | + 'class' => 'push-button', |
| 264 | + 'pushtarget' => $url, |
| 265 | + 'style' => 'width: 125px; height: 30px', |
| 266 | + 'targetid' => $targetId, |
| 267 | + 'targetname' => $name |
| 268 | + ), |
| 269 | + wfMsg( 'push-button-text' ) |
| 270 | + ) |
| 271 | + ) |
| 272 | + ); |
| 273 | + } |
| 274 | + |
| 275 | + /** |
| 276 | + * Outputs the HTML for the push options. |
| 277 | + * |
| 278 | + * @since 0.4 |
| 279 | + */ |
| 280 | + protected static function displayPushOptions() { |
| 281 | + global $wgOut, $wgUser; |
| 282 | + |
| 283 | + $wgOut->addHTML( '<h3>' . htmlspecialchars( wfMsg( 'push-tab-push-options' ) ) . '</h3>' ); |
| 284 | + |
| 285 | + self::displayIncTemplatesOption(); |
| 286 | + |
| 287 | + if ( $wgUser->isAllowed( 'filepush' ) ) { |
| 288 | + self::displayIncFilesOption(); |
| 289 | + } |
| 290 | + } |
| 291 | + |
| 292 | + /** |
| 293 | + * Outputs the HTML for the "include templates" option. |
| 294 | + * |
| 295 | + * @since 0.4 |
| 296 | + */ |
| 297 | + protected static function displayIncTemplatesOption() { |
| 298 | + global $wgOut, $wgTitle, $wgLang, $egPushIncTemplates; |
| 299 | + |
| 300 | + $usedTemplates = array_keys( |
| 301 | + PushFunctions::getTemplates( |
| 302 | + array( $wgTitle->getFullText() ), |
| 303 | + array( $wgTitle->getFullText() => true ) |
| 304 | + ) |
| 305 | + ); |
| 306 | + |
| 307 | + array_shift( $usedTemplates ); |
| 308 | + |
| 309 | + $wgOut->addInlineScript( |
| 310 | + 'var wgPushTemplates = ' . json_encode( $usedTemplates ) . ';' |
| 311 | + ); |
| 312 | + |
| 313 | + foreach ( $usedTemplates as &$template ) { |
| 314 | + $template = "[[$template]]"; |
| 315 | + } |
| 316 | + |
| 317 | + $wgOut->addHTML( |
| 318 | + Html::rawElement( |
| 319 | + 'div', |
| 320 | + array( 'id' => 'divIncTemplates', 'style' => 'display: table-cell' ), |
| 321 | + Xml::check( 'checkIncTemplates', $egPushIncTemplates, array( 'id' => 'checkIncTemplates' ) ) . |
| 322 | + Html::element( |
| 323 | + 'label', |
| 324 | + array( 'id' => 'lblIncTemplates', 'for' => 'checkIncTemplates' ), |
| 325 | + wfMsg( 'push-tab-inc-templates' ) |
| 326 | + ) . |
| 327 | + ' ' . |
| 328 | + Html::rawElement( |
| 329 | + 'div', |
| 330 | + array( 'style' => 'display:inline; opacity:0', 'id' => 'txtTemplateList' ), |
| 331 | + count( $usedTemplates ) > 0 ? |
| 332 | + wfMsgExt( 'push-tab-used-templates', 'parseinline', $wgLang->listToText( $usedTemplates ), count( $usedTemplates ) ) : |
| 333 | + htmlspecialchars( wfMsg( 'push-tab-no-used-templates' ) ) |
| 334 | + ) |
| 335 | + ) |
| 336 | + ); |
| 337 | + } |
| 338 | + |
| 339 | + /** |
| 340 | + * Outputs the HTML for the "include files" option. |
| 341 | + * |
| 342 | + * @since 0.4 |
| 343 | + */ |
| 344 | + protected static function displayIncFilesOption() { |
| 345 | + global $wgOut, $wgTitle, $egPushIncFiles; |
| 346 | + |
| 347 | + $wgOut->addHTML( |
| 348 | + Html::rawElement( |
| 349 | + 'div', |
| 350 | + array( 'id' => 'divIncFiles' ), |
| 351 | + Xml::check( 'checkIncFiles', $egPushIncFiles, array( 'id' => 'checkIncFiles' ) ) . |
| 352 | + Html::element( |
| 353 | + 'label', |
| 354 | + array( 'id' => 'lblIncFiles', 'for' => 'checkIncFiles' ), |
| 355 | + wfMsg( 'push-tab-inc-files' ) |
| 356 | + ) |
| 357 | + ) |
| 358 | + ); |
| 359 | + } |
| 360 | + |
| 361 | +} |
\ No newline at end of file |
Property changes on: tags/extensions/Push/REL_0_5/includes/Push_Tab.php |
___________________________________________________________________ |
Added: svn:eol-style |
1 | 362 | + native |
Index: tags/extensions/Push/REL_0_5/includes/Push_Functions.php |
— | — | @@ -0,0 +1,157 @@ |
| 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 | + /** |
| 17 | + * Adds the needed JS messages to the page output. |
| 18 | + * This is for backward compatibility with pre-RL MediaWiki. |
| 19 | + * |
| 20 | + * @since 0.2 |
| 21 | + */ |
| 22 | + public static function addJSLocalisation() { |
| 23 | + global $egPushJSMessages, $wgOut; |
| 24 | + |
| 25 | + $data = array(); |
| 26 | + |
| 27 | + foreach ( $egPushJSMessages as $msg ) { |
| 28 | + $data[$msg] = wfMsgNoTrans( $msg ); |
| 29 | + } |
| 30 | + |
| 31 | + $wgOut->addInlineScript( 'var wgPushMessages = ' . json_encode( $data ) . ';' ); |
| 32 | + } |
| 33 | + |
| 34 | + /** |
| 35 | + * Returns the latest revision. |
| 36 | + * Has support for the Approvedrevs extension, and will |
| 37 | + * return the latest approved revision where appropriate. |
| 38 | + * |
| 39 | + * @since 0.2 |
| 40 | + * |
| 41 | + * @param Title $title |
| 42 | + * |
| 43 | + * @return integer |
| 44 | + */ |
| 45 | + public static function getRevisionToPush( Title $title ) { |
| 46 | + if ( defined( 'APPROVED_REVS_VERSION' ) ) { |
| 47 | + $revId = ApprovedRevs::getApprovedRevID( $title ); |
| 48 | + return $revId ? $revId : $title->getLatestRevID(); |
| 49 | + } |
| 50 | + else { |
| 51 | + return $title->getLatestRevID(); |
| 52 | + } |
| 53 | + } |
| 54 | + |
| 55 | + /** |
| 56 | + * Expand a list of pages to include templates used in those pages. |
| 57 | + * |
| 58 | + * @since 0.4 |
| 59 | + * |
| 60 | + * @param $inputPages array list of titles to look up |
| 61 | + * @param $pageSet array associative array indexed by titles for output |
| 62 | + * |
| 63 | + * @return array associative array index by titles |
| 64 | + */ |
| 65 | + public static function getTemplates( $inputPages, $pageSet ) { |
| 66 | + return self::getLinks( $inputPages, $pageSet, |
| 67 | + 'templatelinks', |
| 68 | + array( 'tl_namespace AS namespace', 'tl_title AS title' ), |
| 69 | + array( 'page_id=tl_from' ) |
| 70 | + ); |
| 71 | + } |
| 72 | + |
| 73 | + /** |
| 74 | + * Expand a list of pages to include items used in those pages. |
| 75 | + * |
| 76 | + * @since 0.4 |
| 77 | + */ |
| 78 | + protected static function getLinks( $inputPages, $pageSet, $table, $fields, $join ) { |
| 79 | + $dbr = wfGetDB( DB_SLAVE ); |
| 80 | + |
| 81 | + foreach( $inputPages as $page ) { |
| 82 | + $title = Title::newFromText( $page ); |
| 83 | + |
| 84 | + if( $title ) { |
| 85 | + $pageSet[$title->getPrefixedText()] = true; |
| 86 | + /// @todo Fixme: May or may not be more efficient to batch these |
| 87 | + /// by namespace when given multiple input pages. |
| 88 | + $result = $dbr->select( |
| 89 | + array( 'page', $table ), |
| 90 | + $fields, |
| 91 | + array_merge( |
| 92 | + $join, |
| 93 | + array( |
| 94 | + 'page_namespace' => $title->getNamespace(), |
| 95 | + 'page_title' => $title->getDBkey() |
| 96 | + ) |
| 97 | + ), |
| 98 | + __METHOD__ |
| 99 | + ); |
| 100 | + |
| 101 | + foreach( $result as $row ) { |
| 102 | + $template = Title::makeTitle( $row->namespace, $row->title ); |
| 103 | + $pageSet[$template->getPrefixedText()] = true; |
| 104 | + } |
| 105 | + } |
| 106 | + } |
| 107 | + |
| 108 | + return $pageSet; |
| 109 | + } |
| 110 | + |
| 111 | + /** |
| 112 | + * Function to change the keys of $egPushLoginUsers and $egPushLoginPasswords |
| 113 | + * from target url to target name using the $egPushTargets array. |
| 114 | + * |
| 115 | + * @since 0.5 |
| 116 | + * |
| 117 | + * @param array $arr |
| 118 | + * @param string $id Some string to indentify the array and keep track of it having been flipped. |
| 119 | + */ |
| 120 | + public static function flipKeys( array &$arr, $id ) { |
| 121 | + static $handledArrays = array(); |
| 122 | + |
| 123 | + if ( !in_array( $id, $handledArrays ) ) { |
| 124 | + $handledArrays[] = $id; |
| 125 | + |
| 126 | + global $egPushTargets; |
| 127 | + |
| 128 | + $flipped = array(); |
| 129 | + |
| 130 | + foreach ( $arr as $key => $value ) { |
| 131 | + if ( array_key_exists( $key, $egPushTargets ) ) { |
| 132 | + $flipped[$egPushTargets[$key]] = $value; |
| 133 | + } |
| 134 | + } |
| 135 | + |
| 136 | + $arr = $flipped; |
| 137 | + } |
| 138 | + } |
| 139 | + |
| 140 | + /** |
| 141 | + * Returns a new instance of the (MW)HttpRequest class. |
| 142 | + * This is needed to take care of the rename that happened in MediaWiki 1.17. |
| 143 | + * |
| 144 | + * @since 0.5 |
| 145 | + * |
| 146 | + * @param string $target |
| 147 | + * @param array $args |
| 148 | + * |
| 149 | + * @return (MW)HttpRequest |
| 150 | + */ |
| 151 | + public static function getHttpRequest( $target, $args ) { |
| 152 | + return call_user_func_array( |
| 153 | + array( ( class_exists( 'MWHttpRequest' ) ? 'MWHttpRequest' : 'HttpRequest' ), 'factory' ), |
| 154 | + array( $target, $args ) |
| 155 | + ); |
| 156 | + } |
| 157 | + |
| 158 | +} |
\ No newline at end of file |
Property changes on: tags/extensions/Push/REL_0_5/includes/Push_Functions.php |
___________________________________________________________________ |
Added: svn:eol-style |
1 | 159 | + native |
Index: tags/extensions/Push/REL_0_5/includes/ext.push.tab.js |
— | — | @@ -0,0 +1,270 @@ |
| 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 | + var pages; |
| 28 | + var imageRequestMade = false; |
| 29 | + var images = false; |
| 30 | + var imagePushRequests = []; |
| 31 | + |
| 32 | + $.each($(".push-button"), function(i,v) { |
| 33 | + getRemoteArticleInfo( $(v).attr( 'targetid' ), $(v).attr( 'pushtarget' ) ); |
| 34 | + }); |
| 35 | + |
| 36 | + $('.push-button').click(function() { |
| 37 | + this.disabled = true; |
| 38 | + this.innerHTML = mediaWiki.msg( 'push-button-pushing' ); |
| 39 | + |
| 40 | + var errorDiv = $( '#targeterrors' + $(this).attr( 'targetid' ) ); |
| 41 | + errorDiv.fadeOut( 'fast' ); |
| 42 | + |
| 43 | + if ( $('#checkIncTemplates').attr('checked') ) { |
| 44 | + pages = window.wgPushTemplates; |
| 45 | + pages.unshift( $('#pageName').attr('value') ); |
| 46 | + } |
| 47 | + else { |
| 48 | + pages = [$('#pageName').attr('value')]; |
| 49 | + } |
| 50 | + |
| 51 | + initiatePush( |
| 52 | + this, |
| 53 | + pages, |
| 54 | + $(this).attr( 'pushtarget' ), |
| 55 | + $(this).attr( 'targetname' ) |
| 56 | + ); |
| 57 | + |
| 58 | + if ( $('#checkIncFiles').length != 0 && $('#checkIncFiles').attr('checked') && !imageRequestMade ) { |
| 59 | + getIncludedImages(); |
| 60 | + } |
| 61 | + }); |
| 62 | + |
| 63 | + $('#push-all-button').click(function() { |
| 64 | + this.disabled = true; |
| 65 | + this.innerHTML = mediaWiki.msg( 'push-button-pushing' ); |
| 66 | + $.each($(".push-button"), function(i,v) { |
| 67 | + $(v).click(); |
| 68 | + }); |
| 69 | + }); |
| 70 | + |
| 71 | + $('#divIncTemplates').hover( |
| 72 | + function() { |
| 73 | + $('#txtTemplateList').fadeTo( |
| 74 | + ( $('#txtTemplateList').css( 'opacity' ) == 0 ? 'slow' : 'fast' ), |
| 75 | + 1 |
| 76 | + ); |
| 77 | + }, |
| 78 | + function() { |
| 79 | + $('#txtTemplateList').fadeTo( 'fast', 0.5 ) |
| 80 | + } |
| 81 | + ); |
| 82 | + |
| 83 | + function getRemoteArticleInfo( targetId, targetUrl ) { |
| 84 | + $.getJSON( |
| 85 | + targetUrl + '/api.php?callback=?', |
| 86 | + { |
| 87 | + 'action': 'query', |
| 88 | + 'format': 'json', |
| 89 | + 'prop': 'revisions', |
| 90 | + 'rvprop': 'timestamp|user|comment', |
| 91 | + 'titles': $('#pageName').attr('value'), |
| 92 | + }, |
| 93 | + function( data ) { |
| 94 | + if ( data.query ) { |
| 95 | + var infoDiv = $( '#targetinfo' + targetId ); |
| 96 | + |
| 97 | + for ( first in data.query.pages ) break; |
| 98 | + |
| 99 | + if ( first == '-1' ) { |
| 100 | + $( '#targetlink' + targetId ).attr( {'class': 'new'} ); |
| 101 | + var message = mediaWiki.msg( 'push-tab-not-created' ); |
| 102 | + } |
| 103 | + else { |
| 104 | + $( '#targetlink' + targetId ).attr( {'class': ''} ); |
| 105 | + |
| 106 | + var revision = data.query.pages[first].revisions[0]; |
| 107 | + var dateTime = revision.timestamp.split( 'T' ); |
| 108 | + |
| 109 | + var message = mediaWiki.msg( |
| 110 | + 'push-tab-last-edit', |
| 111 | + revision.user, |
| 112 | + dateTime[0], |
| 113 | + dateTime[1].replace( 'Z', '' ) |
| 114 | + ); |
| 115 | + } |
| 116 | + |
| 117 | + infoDiv.text( message ); |
| 118 | + infoDiv.fadeIn( 'slow' ); |
| 119 | + } |
| 120 | + } |
| 121 | + ); |
| 122 | + } |
| 123 | + |
| 124 | + function initiatePush( sender, pages, targetUrl, targetName ) { |
| 125 | + $.getJSON( |
| 126 | + wgScriptPath + '/api.php', |
| 127 | + { |
| 128 | + 'action': 'push', |
| 129 | + 'format': 'json', |
| 130 | + 'page': pages.join( '|' ), |
| 131 | + 'targets': targetUrl |
| 132 | + }, |
| 133 | + function( data ) { |
| 134 | + if ( data.error ) { |
| 135 | + handleError( sender, targetUrl, data.error ); |
| 136 | + } |
| 137 | + else if ( data.length > 0 && data[0].edit && data[0].edit.captcha ) { |
| 138 | + handleError( sender, targetUrl, { info: mediaWiki.msg( 'push-err-captacha', targetName ) } ); |
| 139 | + } |
| 140 | + else { |
| 141 | + if ( $('#checkIncFiles').length != 0 && $('#checkIncFiles').attr('checked') ) { |
| 142 | + setButtonToImgPush( sender, targetUrl, targetName ); |
| 143 | + } |
| 144 | + else { |
| 145 | + sender.innerHTML = mediaWiki.msg( 'push-button-completed' ); |
| 146 | + setTimeout( function() {reEnableButton( sender, targetUrl, targetName );}, 1000 ); |
| 147 | + } |
| 148 | + } |
| 149 | + } |
| 150 | + ); |
| 151 | + } |
| 152 | + |
| 153 | + function setButtonToImgPush( button, targetUrl, targetName ) { |
| 154 | + button.innerHTML = mediaWiki.msg( 'push-button-pushing-files' ); |
| 155 | + imagePushRequests.push( { 'sender': button, 'targetUrl': targetUrl, 'targetName': targetName } ); |
| 156 | + startImagesPush(); |
| 157 | + } |
| 158 | + |
| 159 | + function getIncludedImages() { |
| 160 | + imageRequestMade = true; |
| 161 | + |
| 162 | + $.getJSON( |
| 163 | + wgScriptPath + '/api.php', |
| 164 | + { |
| 165 | + 'action': 'query', |
| 166 | + 'prop': 'images', |
| 167 | + 'format': 'json', |
| 168 | + 'titles': pages.join( '|' ), |
| 169 | + }, |
| 170 | + function( data ) { |
| 171 | + if ( data.query ) { |
| 172 | + images = []; |
| 173 | + |
| 174 | + for ( page in data.query.pages ) { |
| 175 | + if ( data.query.pages[page].images ) { |
| 176 | + for ( var i = data.query.pages[page].images.length - 1; i >= 0; i-- ) { |
| 177 | + if ( $.inArray( data.query.pages[page].images[i].title, images ) == -1 ) { |
| 178 | + images.push( data.query.pages[page].images[i].title ); |
| 179 | + } |
| 180 | + } |
| 181 | + } |
| 182 | + } |
| 183 | + |
| 184 | + startImagesPush(); |
| 185 | + } |
| 186 | + else { |
| 187 | + alert( mediaWiki.msg( 'push-tab-err-fileinfo' ) ); |
| 188 | + } |
| 189 | + } |
| 190 | + ); |
| 191 | + } |
| 192 | + |
| 193 | + function startImagesPush() { |
| 194 | + if ( images !== false ) { |
| 195 | + var req; |
| 196 | + while ( req = imagePushRequests.pop() ) { |
| 197 | + initiateImagePush( req.sender, req.targetUrl, req.targetName ); |
| 198 | + } |
| 199 | + } |
| 200 | + } |
| 201 | + |
| 202 | + function initiateImagePush( sender, targetUrl, targetName ) { |
| 203 | + $.getJSON( |
| 204 | + wgScriptPath + '/api.php', |
| 205 | + { |
| 206 | + 'action': 'pushimages', |
| 207 | + 'format': 'json', |
| 208 | + 'images': images.join( '|' ), |
| 209 | + 'targets': targetUrl |
| 210 | + }, |
| 211 | + function( data ) { |
| 212 | + var fail = false; |
| 213 | + |
| 214 | + for ( i in data ) { |
| 215 | + if ( data[i].error ) { |
| 216 | + handleError( sender, targetUrl, { info: mediaWiki.msg( 'push-tab-err-filepush', data[i].error.info ) } ); |
| 217 | + fail = true; |
| 218 | + break; |
| 219 | + } |
| 220 | + else if ( !data[i].upload ) { |
| 221 | + handleError( sender, targetUrl, { info: mediaWiki.msg( 'push-tab-err-filepush-unknown' ) } ); |
| 222 | + fail = true; |
| 223 | + break; |
| 224 | + } |
| 225 | + } |
| 226 | + |
| 227 | + if ( !fail ) { |
| 228 | + sender.innerHTML = mediaWiki.msg( 'push-button-completed' ); |
| 229 | + setTimeout( function() {reEnableButton( sender, targetUrl, targetName );}, 1000 ); |
| 230 | + } |
| 231 | + } |
| 232 | + ); |
| 233 | + } |
| 234 | + |
| 235 | + function reEnableButton( button, targetUrl, targetName ) { |
| 236 | + button.innerHTML = mediaWiki.msg( 'push-button-text' ); |
| 237 | + button.disabled = false; |
| 238 | + |
| 239 | + getRemoteArticleInfo( $(button).attr( 'targetid' ), $(button).attr( 'pushtarget' ) ); |
| 240 | + |
| 241 | + var pushAllButton = $('#push-all-button'); |
| 242 | + |
| 243 | + // If there is a "push all" button, make sure to reset it |
| 244 | + // when all other buttons have been reset. |
| 245 | + if ( typeof pushAllButton !== "undefined" ) { |
| 246 | + var hasDisabled = false; |
| 247 | + |
| 248 | + $.each($(".push-button"), function(i,v) { |
| 249 | + if ( v.disabled ) { |
| 250 | + hasDisabled = true; |
| 251 | + } |
| 252 | + }); |
| 253 | + |
| 254 | + if ( !hasDisabled ) { |
| 255 | + pushAllButton.attr( "disabled", false ); |
| 256 | + pushAllButton.text( mediaWiki.msg( 'push-button-all' ) ); |
| 257 | + } |
| 258 | + } |
| 259 | + } |
| 260 | + |
| 261 | + function handleError( sender, targetUrl, error ) { |
| 262 | + var errorDiv = $( '#targeterrors' + $(sender).attr( 'targetid' ) ); |
| 263 | + |
| 264 | + errorDiv.text( error.info ); |
| 265 | + errorDiv.fadeIn( 'slow' ); |
| 266 | + |
| 267 | + sender.innerHTML = mediaWiki.msg( 'push-button-failed' ); |
| 268 | + setTimeout( function() {reEnableButton( sender );}, 2500 ); |
| 269 | + } |
| 270 | + |
| 271 | +} ); })(jQuery); |
\ No newline at end of file |
Property changes on: tags/extensions/Push/REL_0_5/includes/ext.push.tab.js |
___________________________________________________________________ |
Added: svn:eol-style |
1 | 272 | + native |
Index: tags/extensions/Push/REL_0_5/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_5/Push.hooks.php |
___________________________________________________________________ |
Added: svn:eol-style |
1 | 32 | + native |
Index: tags/extensions/Push/REL_0_5/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_5/api/ApiPush.php |
— | — | @@ -0,0 +1,404 @@ |
| 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 | + protected $editResponses = array(); |
| 17 | + |
| 18 | + /** |
| 19 | + * Associative array containing CookieJar objects (values) to be passed in |
| 20 | + * order to autenticate to the targets (keys). |
| 21 | + * |
| 22 | + * @since 0.4 |
| 23 | + * |
| 24 | + * @var array |
| 25 | + */ |
| 26 | + protected $cookieJars = array(); |
| 27 | + |
| 28 | + public function __construct( $main, $action ) { |
| 29 | + parent::__construct( $main, $action ); |
| 30 | + } |
| 31 | + |
| 32 | + public function execute() { |
| 33 | + global $egPushLoginUser, $egPushLoginPass, $egPushLoginUsers, $egPushLoginPasswords; |
| 34 | + |
| 35 | + $params = $this->extractRequestParams(); |
| 36 | + |
| 37 | + if ( !isset( $params['page'] ) ) { |
| 38 | + $this->dieUsageMsg( array( 'missingparam', 'page' ) ); |
| 39 | + } |
| 40 | + |
| 41 | + if ( !isset( $params['targets'] ) ) { |
| 42 | + $this->dieUsageMsg( array( 'missingparam', 'targets' ) ); |
| 43 | + } |
| 44 | + |
| 45 | + PushFunctions::flipKeys( $egPushLoginUsers, 'users' ); |
| 46 | + PushFunctions::flipKeys( $egPushLoginPasswords, 'passwds' ); |
| 47 | + |
| 48 | + foreach ( $params['targets'] as &$target ) { |
| 49 | + $user = false; |
| 50 | + $pass = false; |
| 51 | + |
| 52 | + if ( array_key_exists( $target, $egPushLoginUsers ) && array_key_exists( $target, $egPushLoginPasswords ) ) { |
| 53 | + $user = $egPushLoginUsers[$target]; |
| 54 | + $pass = $egPushLoginPasswords[$target]; |
| 55 | + } |
| 56 | + else if ( $egPushLoginUser != '' && $egPushLoginPass != '' ) { |
| 57 | + $user = $egPushLoginUser; |
| 58 | + $pass = $egPushLoginPass; |
| 59 | + } |
| 60 | + |
| 61 | + if ( substr( $target, -1 ) !== '/' ) { |
| 62 | + $target .= '/'; |
| 63 | + } |
| 64 | + |
| 65 | + $target .= 'api.php'; |
| 66 | + |
| 67 | + if ( $user !== false ) { |
| 68 | + $this->doLogin( $user, $pass, $target ); |
| 69 | + } |
| 70 | + } |
| 71 | + |
| 72 | + foreach ( $params['page'] as $page ) { |
| 73 | + $title = Title::newFromText( $page ); |
| 74 | + |
| 75 | + $revision = $this->getPageRevision( $title ); |
| 76 | + |
| 77 | + if ( $revision !== false ) { |
| 78 | + $this->doPush( $title, $revision, $params['targets'] ); |
| 79 | + } |
| 80 | + } |
| 81 | + |
| 82 | + if ( count( $this->editResponses ) == 1 ) { |
| 83 | + $this->getResult()->addValue( |
| 84 | + null, |
| 85 | + null, |
| 86 | + FormatJson::decode( $this->editResponses[0] ) |
| 87 | + ); |
| 88 | + } |
| 89 | + else { |
| 90 | + $success = true; |
| 91 | + |
| 92 | + foreach ( $this->editResponses as $response ) { |
| 93 | + $this->getResult()->addValue( |
| 94 | + null, |
| 95 | + null, |
| 96 | + FormatJson::decode( $response ) |
| 97 | + ); |
| 98 | + } |
| 99 | + } |
| 100 | + } |
| 101 | + |
| 102 | + /** |
| 103 | + * Logs in into a target wiki using the provided username and password. |
| 104 | + * |
| 105 | + * @since 0.4 |
| 106 | + * |
| 107 | + * @param string $user |
| 108 | + * @param string $password |
| 109 | + * @param string $target |
| 110 | + * @param string $token |
| 111 | + * @param CookieJar $cookie |
| 112 | + * @param integer $attemtNr |
| 113 | + */ |
| 114 | + protected function doLogin( $user, $password, $target, $token = null, $cookieJar = null, $attemtNr = 0 ) { |
| 115 | + $requestData = array( |
| 116 | + 'action' => 'login', |
| 117 | + 'format' => 'json', |
| 118 | + 'lgname' => $user, |
| 119 | + 'lgpassword' => $password |
| 120 | + ); |
| 121 | + |
| 122 | + if ( !is_null( $token ) ) { |
| 123 | + $requestData['lgtoken'] = $token; |
| 124 | + } |
| 125 | + |
| 126 | + $req = PushFunctions::getHttpRequest( $target, |
| 127 | + array( |
| 128 | + 'postData' => $requestData, |
| 129 | + 'method' => 'POST', |
| 130 | + 'timeout' => 'default' |
| 131 | + ) |
| 132 | + ); |
| 133 | + |
| 134 | + if ( !is_null( $cookieJar ) ) { |
| 135 | + $req->setCookieJar( $cookieJar ); |
| 136 | + } |
| 137 | + |
| 138 | + $status = $req->execute(); |
| 139 | + |
| 140 | + $attemtNr++; |
| 141 | + |
| 142 | + if ( $status->isOK() ) { |
| 143 | + $response = FormatJson::decode( $req->getContent() ); |
| 144 | + |
| 145 | + if ( property_exists( $response, 'login' ) |
| 146 | + && property_exists( $response->login, 'result' ) ) { |
| 147 | + |
| 148 | + if ( $response->login->result == 'NeedToken' && $attemtNr < 3 ) { |
| 149 | + $this->doLogin( $user, $password, $target, $response->login->token, $req->getCookieJar(), $attemtNr ); |
| 150 | + } |
| 151 | + else if ( $response->login->result == 'Success' ) { |
| 152 | + $this->cookieJars[$target] = $req->getCookieJar(); |
| 153 | + } |
| 154 | + else { |
| 155 | + $this->dieUsage( wfMsgExt( 'push-err-authentication', 'parsemag', $target, '' ), 'authentication-failed' ); |
| 156 | + } |
| 157 | + } |
| 158 | + else { |
| 159 | + $this->dieUsage( wfMsgExt( 'push-err-authentication', 'parsemag', $target, '' ), 'authentication-failed' ); |
| 160 | + } |
| 161 | + } |
| 162 | + else { |
| 163 | + $this->dieUsage( wfMsgExt( 'push-err-authentication', 'parsemag', $target, '' ), 'authentication-failed' ); |
| 164 | + } |
| 165 | + } |
| 166 | + |
| 167 | + /** |
| 168 | + * Makes an internal request to the API to get the needed revision. |
| 169 | + * |
| 170 | + * @since 0.3 |
| 171 | + * |
| 172 | + * @param Title $title |
| 173 | + * |
| 174 | + * @return array or false |
| 175 | + */ |
| 176 | + protected function getPageRevision( Title $title ) { |
| 177 | + $revId = PushFunctions::getRevisionToPush( $title ); |
| 178 | + |
| 179 | + $requestData = array( |
| 180 | + 'action' => 'query', |
| 181 | + 'format' => 'json', |
| 182 | + 'prop' => 'revisions', |
| 183 | + 'rvprop' => 'timestamp|user|comment|content', |
| 184 | + 'titles' => $title->getFullText(), |
| 185 | + 'rvstartid' => $revId, |
| 186 | + 'rvendid' => $revId, |
| 187 | + ); |
| 188 | + |
| 189 | + $api = new ApiMain( new FauxRequest( $requestData, true ), true ); |
| 190 | + $api->execute(); |
| 191 | + $response = $api->getResultData(); |
| 192 | + |
| 193 | + $revision = false; |
| 194 | + |
| 195 | + if ( $response !== false |
| 196 | + && array_key_exists( 'query', $response ) |
| 197 | + && array_key_exists( 'pages', $response['query'] ) |
| 198 | + && count( $response['query']['pages'] ) > 0 ) { |
| 199 | + |
| 200 | + foreach ( $response['query']['pages'] as $key => $value ) { |
| 201 | + $first = $key; |
| 202 | + break; |
| 203 | + } |
| 204 | + |
| 205 | + if ( array_key_exists( 'revisions', $response['query']['pages'][$first] ) |
| 206 | + && count( $response['query']['pages'][$first]['revisions'] ) > 0 ) { |
| 207 | + $revision = $response['query']['pages'][$first]['revisions'][0]; |
| 208 | + } |
| 209 | + else { |
| 210 | + $this->dieUsage( wfMsg( 'push-special-err-pageget-failed' ), 'page-get-failed' ); |
| 211 | + } |
| 212 | + } |
| 213 | + else { |
| 214 | + $this->dieUsage( wfMsg( 'push-special-err-pageget-failed' ), 'page-get-failed' ); |
| 215 | + } |
| 216 | + |
| 217 | + return $revision; |
| 218 | + } |
| 219 | + |
| 220 | + /** |
| 221 | + * Pushes the page content to the target wikis. |
| 222 | + * |
| 223 | + * @since 0.3 |
| 224 | + * |
| 225 | + * @param Title $title |
| 226 | + * @param array $revision |
| 227 | + * @param array $targets |
| 228 | + */ |
| 229 | + protected function doPush( Title $title, array $revision, array $targets ) { |
| 230 | + foreach ( $targets as $target ) { |
| 231 | + $token = $this->getEditToken( $title, $target ); |
| 232 | + |
| 233 | + if ( $token !== false ) { |
| 234 | + $this->pushToTarget( $title, $revision, $target, $token ); |
| 235 | + } |
| 236 | + } |
| 237 | + } |
| 238 | + |
| 239 | + /** |
| 240 | + * Obtains the needed edit token by making an HTTP GET request |
| 241 | + * to the remote wikis API. |
| 242 | + * |
| 243 | + * @since 0.3 |
| 244 | + * |
| 245 | + * @param Title $title |
| 246 | + * @param string $target |
| 247 | + * |
| 248 | + * @return string or false |
| 249 | + */ |
| 250 | + protected function getEditToken( Title $title, $target ) { |
| 251 | + $requestData = array( |
| 252 | + 'action' => 'query', |
| 253 | + 'format' => 'json', |
| 254 | + 'intoken' => 'edit', |
| 255 | + 'prop' => 'info', |
| 256 | + 'titles' => $title->getFullText(), |
| 257 | + ); |
| 258 | + |
| 259 | + $parts = array(); |
| 260 | + |
| 261 | + foreach ( $requestData as $key => $value ) { |
| 262 | + $parts[] = $key . '=' . urlencode( $value ); |
| 263 | + } |
| 264 | + |
| 265 | + $req = PushFunctions::getHttpRequest( $target . '?' . implode( '&', $parts ), |
| 266 | + array( |
| 267 | + 'method' => 'GET', |
| 268 | + 'timeout' => 'default' |
| 269 | + ) |
| 270 | + ); |
| 271 | + |
| 272 | + if ( array_key_exists( $target, $this->cookieJars ) ) { |
| 273 | + $req->setCookieJar( $this->cookieJars[$target] ); |
| 274 | + } |
| 275 | + |
| 276 | + $status = $req->execute(); |
| 277 | + |
| 278 | + $response = $status->isOK() ? FormatJson::decode( $req->getContent() ) : null; |
| 279 | + |
| 280 | + $token = false; |
| 281 | + |
| 282 | + if ( !is_null( $response ) |
| 283 | + && property_exists( $response, 'query' ) |
| 284 | + && property_exists( $response->query, 'pages' ) |
| 285 | + && count( $response->query->pages ) > 0 ) { |
| 286 | + |
| 287 | + foreach ( $response->query->pages as $key => $value ) { |
| 288 | + $first = $key; |
| 289 | + break; |
| 290 | + } |
| 291 | + |
| 292 | + if ( property_exists( $response->query->pages->$first, 'edittoken' ) ) { |
| 293 | + $token = $response->query->pages->$first->edittoken; |
| 294 | + } |
| 295 | + elseif ( !is_null( $response ) && property_exists( $response, 'query' ) && property_exists( $response->query, 'error' ) ) { |
| 296 | + $this->dieUsage( $response->query->error->message, 'token-request-failed' ); |
| 297 | + } |
| 298 | + else { |
| 299 | + $this->dieUsage( wfMsg( 'push-special-err-token-failed' ), 'token-request-failed' ); |
| 300 | + } |
| 301 | + } |
| 302 | + else { |
| 303 | + $this->dieUsage( wfMsg( 'push-special-err-token-failed' ), 'token-request-failed' ); |
| 304 | + } |
| 305 | + |
| 306 | + return $token; |
| 307 | + } |
| 308 | + |
| 309 | + /** |
| 310 | + * Pushes the page content to the specified wiki. |
| 311 | + * |
| 312 | + * @since 0.3 |
| 313 | + * |
| 314 | + * @param Title $title |
| 315 | + * @param array $revision |
| 316 | + * @param string $target |
| 317 | + * @param string $token |
| 318 | + */ |
| 319 | + protected function pushToTarget( Title $title, array $revision, $target, $token ) { |
| 320 | + global $wgSitename; |
| 321 | + |
| 322 | + $summary = wfMsgExt( |
| 323 | + 'push-import-revision-message', |
| 324 | + 'parsemag', |
| 325 | + $wgSitename, |
| 326 | + $revision['user'] |
| 327 | + ); |
| 328 | + |
| 329 | + $requestData = array( |
| 330 | + 'action' => 'edit', |
| 331 | + 'title' => $title->getFullText(), |
| 332 | + 'format' => 'json', |
| 333 | + 'summary' => $summary, |
| 334 | + 'text' => $revision['*'], |
| 335 | + 'token' => $token, |
| 336 | + ); |
| 337 | + |
| 338 | + $req = PushFunctions::getHttpRequest( $target, |
| 339 | + array( |
| 340 | + 'method' => 'POST', |
| 341 | + 'timeout' => 'default', |
| 342 | + 'postData' => $requestData |
| 343 | + ) |
| 344 | + ); |
| 345 | + |
| 346 | + if ( array_key_exists( $target, $this->cookieJars ) ) { |
| 347 | + $req->setCookieJar( $this->cookieJars[$target] ); |
| 348 | + } |
| 349 | + |
| 350 | + $status = $req->execute(); |
| 351 | + |
| 352 | + if ( $status->isOK() ) { |
| 353 | + $this->editResponses[] = $req->getContent(); |
| 354 | + } |
| 355 | + else { |
| 356 | + $this->dieUsage( wfMsg( 'push-special-err-push-failed' ), 'page-push-failed' ); |
| 357 | + } |
| 358 | + } |
| 359 | + |
| 360 | + public function getAllowedParams() { |
| 361 | + return array( |
| 362 | + 'page' => array( |
| 363 | + ApiBase::PARAM_TYPE => 'string', |
| 364 | + ApiBase::PARAM_ISMULTI => true, |
| 365 | + //ApiBase::PARAM_REQUIRED => true, |
| 366 | + ), |
| 367 | + 'targets' => array( |
| 368 | + ApiBase::PARAM_TYPE => 'string', |
| 369 | + ApiBase::PARAM_ISMULTI => true, |
| 370 | + //ApiBase::PARAM_REQUIRED => true, |
| 371 | + ), |
| 372 | + ); |
| 373 | + } |
| 374 | + |
| 375 | + public function getParamDescription() { |
| 376 | + return array( |
| 377 | + 'page' => 'The names of the page to push. Delimitered by |', |
| 378 | + 'targets' => 'The urls of the wikis to push to. Delimitered by |', |
| 379 | + ); |
| 380 | + } |
| 381 | + |
| 382 | + public function getDescription() { |
| 383 | + return array( |
| 384 | + 'Pushes the content of one ore more pages to one or more target wikis.' |
| 385 | + ); |
| 386 | + } |
| 387 | + |
| 388 | + public function getPossibleErrors() { |
| 389 | + return array_merge( parent::getPossibleErrors(), array( |
| 390 | + array( 'missingparam', 'page' ), |
| 391 | + array( 'missingparam', 'targets' ), |
| 392 | + ) ); |
| 393 | + } |
| 394 | + |
| 395 | + protected function getExamples() { |
| 396 | + return array( |
| 397 | + 'api.php?action=push&page=Main page&targets=http://en.wikipedia.org/w', |
| 398 | + ); |
| 399 | + } |
| 400 | + |
| 401 | + public function getVersion() { |
| 402 | + return __CLASS__ . ': $Id: ApiPush.php 78396 2010-12-14 19:03:38Z jeroendedauw $'; |
| 403 | + } |
| 404 | + |
| 405 | +} |
Property changes on: tags/extensions/Push/REL_0_5/api/ApiPush.php |
___________________________________________________________________ |
Added: svn:eol-style |
1 | 406 | + native |
Index: tags/extensions/Push/REL_0_5/api/ApiPushImages.php |
— | — | @@ -0,0 +1,322 @@ |
| 2 | +<?php |
| 3 | + |
| 4 | +/** |
| 5 | + * API module to push images to other MediaWiki wikis. |
| 6 | + * |
| 7 | + * @since 0.5 |
| 8 | + * |
| 9 | + * @file ApiPushImages.php |
| 10 | + * @ingroup Push |
| 11 | + * |
| 12 | + * @author Jeroen De Dauw < jeroendedauw@gmail.com > |
| 13 | + */ |
| 14 | +class ApiPushImages extends ApiBase { |
| 15 | + |
| 16 | + /** |
| 17 | + * Associative array containing CookieJar objects (values) to be passed in |
| 18 | + * order to autenticate to the targets (keys). |
| 19 | + * |
| 20 | + * @since 0.5 |
| 21 | + * |
| 22 | + * @var array |
| 23 | + */ |
| 24 | + protected $cookieJars = array(); |
| 25 | + |
| 26 | + public function __construct( $main, $action ) { |
| 27 | + parent::__construct( $main, $action ); |
| 28 | + } |
| 29 | + |
| 30 | + public function execute() { |
| 31 | + global $egPushLoginUser, $egPushLoginPass, $egPushLoginUsers, $egPushLoginPasswords; |
| 32 | + |
| 33 | + $params = $this->extractRequestParams(); |
| 34 | + |
| 35 | + if ( !isset( $params['images'] ) ) { |
| 36 | + $this->dieUsageMsg( array( 'missingparam', 'images' ) ); |
| 37 | + } |
| 38 | + |
| 39 | + if ( !isset( $params['targets'] ) ) { |
| 40 | + $this->dieUsageMsg( array( 'missingparam', 'targets' ) ); |
| 41 | + } |
| 42 | + |
| 43 | + PushFunctions::flipKeys( $egPushLoginUsers, 'users' ); |
| 44 | + PushFunctions::flipKeys( $egPushLoginPasswords, 'passwds' ); |
| 45 | + |
| 46 | + foreach ( $params['targets'] as &$target ) { |
| 47 | + $user = false; |
| 48 | + $pass = false; |
| 49 | + |
| 50 | + if ( array_key_exists( $target, $egPushLoginUsers ) && array_key_exists( $target, $egPushLoginPasswords ) ) { |
| 51 | + $user = $egPushLoginUsers[$target]; |
| 52 | + $pass = $egPushLoginPasswords[$target]; |
| 53 | + } |
| 54 | + else if ( $egPushLoginUser != '' && $egPushLoginPass != '' ) { |
| 55 | + $user = $egPushLoginUser; |
| 56 | + $pass = $egPushLoginPass; |
| 57 | + } |
| 58 | + |
| 59 | + if ( substr( $target, -1 ) !== '/' ) { |
| 60 | + $target .= '/'; |
| 61 | + } |
| 62 | + |
| 63 | + $target .= 'api.php'; |
| 64 | + |
| 65 | + if ( $user !== false ) { |
| 66 | + $this->doLogin( $user, $pass, $target ); |
| 67 | + } |
| 68 | + } |
| 69 | + |
| 70 | + foreach ( $params['images'] as $image ) { |
| 71 | + $title = Title::newFromText( $image, NS_FILE ); |
| 72 | + if ( !is_null( $title ) && $title->getNamespace() == NS_FILE && $title->exists() ) { |
| 73 | + $this->doPush( $title, $params['targets'] ); |
| 74 | + } |
| 75 | + } |
| 76 | + } |
| 77 | + |
| 78 | + /** |
| 79 | + * Logs in into a target wiki using the provided username and password. |
| 80 | + * |
| 81 | + * @since 0.5 |
| 82 | + * |
| 83 | + * @param string $user |
| 84 | + * @param string $password |
| 85 | + * @param string $target |
| 86 | + * @param string $token |
| 87 | + * @param CookieJar $cookie |
| 88 | + * @param integer $attemtNr |
| 89 | + */ |
| 90 | + protected function doLogin( $user, $password, $target, $token = null, $cookieJar = null, $attemtNr = 0 ) { |
| 91 | + $requestData = array( |
| 92 | + 'action' => 'login', |
| 93 | + 'format' => 'json', |
| 94 | + 'lgname' => $user, |
| 95 | + 'lgpassword' => $password |
| 96 | + ); |
| 97 | + |
| 98 | + if ( !is_null( $token ) ) { |
| 99 | + $requestData['lgtoken'] = $token; |
| 100 | + } |
| 101 | + |
| 102 | + $req = PushFunctions::getHttpRequest( $target, |
| 103 | + array( |
| 104 | + 'postData' => $requestData, |
| 105 | + 'method' => 'POST', |
| 106 | + 'timeout' => 'default' |
| 107 | + ) |
| 108 | + ); |
| 109 | + |
| 110 | + if ( !is_null( $cookieJar ) ) { |
| 111 | + $req->setCookieJar( $cookieJar ); |
| 112 | + } |
| 113 | + |
| 114 | + $status = $req->execute(); |
| 115 | + |
| 116 | + $attemtNr++; |
| 117 | + |
| 118 | + if ( $status->isOK() ) { |
| 119 | + $response = FormatJson::decode( $req->getContent() ); |
| 120 | + |
| 121 | + if ( property_exists( $response, 'login' ) |
| 122 | + && property_exists( $response->login, 'result' ) ) { |
| 123 | + |
| 124 | + if ( $response->login->result == 'NeedToken' && $attemtNr < 3 ) { |
| 125 | + $this->doLogin( $user, $password, $target, $response->login->token, $req->getCookieJar(), $attemtNr ); |
| 126 | + } |
| 127 | + else if ( $response->login->result == 'Success' ) { |
| 128 | + $this->cookieJars[$target] = $req->getCookieJar(); |
| 129 | + } |
| 130 | + else { |
| 131 | + $this->dieUsage( wfMsgExt( 'push-err-authentication', 'parsemag', $target, '' ), 'authentication-failed' ); |
| 132 | + } |
| 133 | + } |
| 134 | + else { |
| 135 | + $this->dieUsage( wfMsgExt( 'push-err-authentication', 'parsemag', $target, '' ), 'authentication-failed' ); |
| 136 | + } |
| 137 | + } |
| 138 | + else { |
| 139 | + $this->dieUsage( wfMsgExt( 'push-err-authentication', 'parsemag', $target, '' ), 'authentication-failed' ); |
| 140 | + } |
| 141 | + } |
| 142 | + |
| 143 | + /** |
| 144 | + * Pushes the page content to the target wikis. |
| 145 | + * |
| 146 | + * @since 0.5 |
| 147 | + * |
| 148 | + * @param Title $title |
| 149 | + * @param array $targets |
| 150 | + */ |
| 151 | + protected function doPush( Title $title, array $targets ) { |
| 152 | + foreach ( $targets as $target ) { |
| 153 | + $token = $this->getEditToken( $title, $target ); |
| 154 | + |
| 155 | + if ( $token !== false ) { |
| 156 | + $this->pushToTarget( $title, $target, $token ); |
| 157 | + } |
| 158 | + } |
| 159 | + } |
| 160 | + |
| 161 | + /** |
| 162 | + * Obtains the needed edit token by making an HTTP GET request |
| 163 | + * to the remote wikis API. |
| 164 | + * |
| 165 | + * @since 0.5 |
| 166 | + * |
| 167 | + * @param Title $title |
| 168 | + * @param string $target |
| 169 | + * |
| 170 | + * @return string or false |
| 171 | + */ |
| 172 | + protected function getEditToken( Title $title, $target ) { |
| 173 | + $requestData = array( |
| 174 | + 'action' => 'query', |
| 175 | + 'format' => 'json', |
| 176 | + 'intoken' => 'edit', |
| 177 | + 'prop' => 'info', |
| 178 | + 'titles' => $title->getFullText(), |
| 179 | + ); |
| 180 | + |
| 181 | + $parts = array(); |
| 182 | + |
| 183 | + foreach ( $requestData as $key => $value ) { |
| 184 | + $parts[] = $key . '=' . urlencode( $value ); |
| 185 | + } |
| 186 | + |
| 187 | + $req = PushFunctions::getHttpRequest( $target . '?' . implode( '&', $parts ), |
| 188 | + array( |
| 189 | + 'method' => 'GET', |
| 190 | + 'timeout' => 'default' |
| 191 | + ) |
| 192 | + ); |
| 193 | + |
| 194 | + if ( array_key_exists( $target, $this->cookieJars ) ) { |
| 195 | + $req->setCookieJar( $this->cookieJars[$target] ); |
| 196 | + } |
| 197 | + |
| 198 | + $status = $req->execute(); |
| 199 | + |
| 200 | + $response = $status->isOK() ? FormatJson::decode( $req->getContent() ) : null; |
| 201 | + |
| 202 | + $token = false; |
| 203 | + |
| 204 | + if ( !is_null( $response ) |
| 205 | + && property_exists( $response, 'query' ) |
| 206 | + && property_exists( $response->query, 'pages' ) |
| 207 | + && count( $response->query->pages ) > 0 ) { |
| 208 | + |
| 209 | + foreach ( $response->query->pages as $key => $value ) { |
| 210 | + $first = $key; |
| 211 | + break; |
| 212 | + } |
| 213 | + |
| 214 | + if ( property_exists( $response->query->pages->$first, 'edittoken' ) ) { |
| 215 | + $token = $response->query->pages->$first->edittoken; |
| 216 | + } |
| 217 | + elseif ( !is_null( $response ) && property_exists( $response, 'query' ) && property_exists( $response->query, 'error' ) ) { |
| 218 | + $this->dieUsage( $response->query->error->message, 'token-request-failed' ); |
| 219 | + } |
| 220 | + else { |
| 221 | + $this->dieUsage( wfMsg( 'push-special-err-token-failed' ), 'token-request-failed' ); |
| 222 | + } |
| 223 | + } |
| 224 | + else { |
| 225 | + $this->dieUsage( wfMsg( 'push-special-err-token-failed' ), 'token-request-failed' ); |
| 226 | + } |
| 227 | + |
| 228 | + return $token; |
| 229 | + } |
| 230 | + |
| 231 | + /** |
| 232 | + * Pushes the image to the specified wiki. |
| 233 | + * |
| 234 | + * @since 0.5 |
| 235 | + * |
| 236 | + * @param Title $title |
| 237 | + * @param string $target |
| 238 | + * @param string $token |
| 239 | + */ |
| 240 | + protected function pushToTarget( Title $title, $target, $token ) { |
| 241 | + $imagePage = new ImagePage( $title ); |
| 242 | + |
| 243 | + $requestData = array( |
| 244 | + 'action' => 'upload', |
| 245 | + 'format' => 'json', |
| 246 | + 'token' => $token, |
| 247 | + 'url' => $imagePage->getDisplayedFile()->getFullUrl(), |
| 248 | + 'filename' => $title->getText(), |
| 249 | + 'ignorewarnings' => '1' |
| 250 | + ); |
| 251 | + |
| 252 | + $req = PushFunctions::getHttpRequest( $target, |
| 253 | + array( |
| 254 | + 'method' => 'POST', |
| 255 | + 'timeout' => 'default', |
| 256 | + 'postData' => $requestData, |
| 257 | + ) |
| 258 | + ); |
| 259 | + |
| 260 | + if ( array_key_exists( $target, $this->cookieJars ) ) { |
| 261 | + $req->setCookieJar( $this->cookieJars[$target] ); |
| 262 | + } |
| 263 | + |
| 264 | + $status = $req->execute(); |
| 265 | + |
| 266 | + if ( $status->isOK() ) { |
| 267 | + $this->getResult()->addValue( |
| 268 | + null, |
| 269 | + null, |
| 270 | + FormatJson::decode( $req->getContent() ) |
| 271 | + ); |
| 272 | + } |
| 273 | + else { |
| 274 | + // TODO |
| 275 | + } |
| 276 | + } |
| 277 | + |
| 278 | + public function getAllowedParams() { |
| 279 | + return array( |
| 280 | + 'images' => array( |
| 281 | + ApiBase::PARAM_TYPE => 'string', |
| 282 | + ApiBase::PARAM_ISMULTI => true, |
| 283 | + //ApiBase::PARAM_REQUIRED => true, |
| 284 | + ), |
| 285 | + 'targets' => array( |
| 286 | + ApiBase::PARAM_TYPE => 'string', |
| 287 | + ApiBase::PARAM_ISMULTI => true, |
| 288 | + //ApiBase::PARAM_REQUIRED => true, |
| 289 | + ), |
| 290 | + ); |
| 291 | + } |
| 292 | + |
| 293 | + public function getParamDescription() { |
| 294 | + return array( |
| 295 | + 'images' => 'The names of the images to push. Delimitered by |', |
| 296 | + 'targets' => 'The urls of the wikis to push to. Delimitered by |', |
| 297 | + ); |
| 298 | + } |
| 299 | + |
| 300 | + public function getDescription() { |
| 301 | + return array( |
| 302 | + 'Pushes the content of one ore more pages to one or more target wikis.' |
| 303 | + ); |
| 304 | + } |
| 305 | + |
| 306 | + public function getPossibleErrors() { |
| 307 | + return array_merge( parent::getPossibleErrors(), array( |
| 308 | + array( 'missingparam', 'images' ), |
| 309 | + array( 'missingparam', 'targets' ), |
| 310 | + ) ); |
| 311 | + } |
| 312 | + |
| 313 | + protected function getExamples() { |
| 314 | + return array( |
| 315 | + 'api.php?action=pushimages&images=File:Foo.bar&targets=http://en.wikipedia.org/w', |
| 316 | + ); |
| 317 | + } |
| 318 | + |
| 319 | + public function getVersion() { |
| 320 | + return __CLASS__ . ': $Id: ApiPushImages.php 78361 2010-12-14 09:38:38Z jeroendedauw $'; |
| 321 | + } |
| 322 | + |
| 323 | +} |
Property changes on: tags/extensions/Push/REL_0_5/api/ApiPushImages.php |
___________________________________________________________________ |
Added: svn:eol-style |
1 | 324 | + native |
Index: tags/extensions/Push/REL_0_5/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_5/Push.alias.php |
___________________________________________________________________ |
Added: svn:eol-style |
1 | 25 | + native |
Index: tags/extensions/Push/REL_0_5/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 lightweight tool that adds an extra tab to articles which |
| 10 | +enables users to push the content of the article to one or more other MediaWiki wikis. |
\ No newline at end of file |