Pengaya:PerbincanganTerstruktur

Pengaya StructuredDiscussions (PerbincanganTerstruktur) menyediakan sistem perbincangan dan kerja sama untuk halaman pembicaraan. Halaman ini mencakup cara memasang dan mengurus Perbincangan Terstruktur; untuk panduan cara menggunakannya, lihat Bantuan:Pembicaraan Terstruktur . Anda dapat mencoba Perbincangan Terstruktur sendiri di Halaman pembicaraan bak pasir ini.

Pengaya ini sebelumnya dikenal sebagai Flow, dan nama-nama di beberapa tempat (seperti repositori Git) masih mencerminkan itu.

Pengaya PerbincanganTerstruktur dikembangkan oleh tim Kolaborasi di Yayasan Wikimedia. Pengaya ini masih terus dipelihara untuk memperbaiki kekutu, tetapi tak ada pengembangan berbobot yang dilakukan pada pengaya tersebut sejak 2015, selain penggantian nama menjadi "StructuredDiscussions" pada September 2017. Untuk informasi lebih tentang status pengembangan pengaya ini, serta ikhtisar mengenai rancangannya, lihat Structured Discussions.

• Pastikan bahwa semua kebergantungan yang diperlukan disetel dan dikonfigurasi.
• Pastikan untuk mengatur $wgVirtualRestConfig['modules']['parsoid']['url'] untuk menunjuk ke rest.php dari wiki Anda.
• Jika Anda punya masalah di MediaWiki 1.40, Anda harus membuat beberapa perubahan untuk menghapus virtualrestconfig-nya restbase di Flow. Lihat tugas T337223.
• Unduh dan pindahkan folder Flow yang diekstrak ke direktori extensions/ Anda.
  Pengembang dan penyumbangsih kode sebaiknya memasang pengaya dari Git sebagai gantinya, menggunakan:

  cdextensions/
  gitclonehttps://gerrit.wikimedia.org/r/mediawiki/extensions/Flow
  

• Hanya ketika memasang dari Git, jalankan Composer untuk memasang ketergantungan PHP, dengan mengeluarkan perintah composer install --no-dev di direktori pengaya. (Lihat T173141 untuk komplikasi yang mungkin terjadi.)
• Tambahkan kode berikut di bawah berkas LocalSettings.php Anda:

  wfLoadExtension( 'Flow' );
  

• Jalankan skrip pembaruan yang akan membuat tabel pangkalan data yang diperlukan pengaya ini secara otomatis.
• Yes Selesai – Telusuri ke Special:Version di wiki Anda untuk memastikan pengayanya berhasil dipasang.

Pemasangan Vagrant:

• Jika menggunakan Vagrant , pasanglah dengan vagrant roles enable flow --provision

Pastikan Anda mengikuti petunjuk lengkap untuk menyalakan atau mematikan PerbincanganTerstruktur, termasuk skrip-skrip yang disebut di sini.

diperlukan

• Extension:Echo - untuk pemberitahuan (misal balasan ke postingan Anda)
• Diperlukan adanya tembolok objek. Anda disarankan untuk menggunakan memcached untuk ini. Anda mungkin mengalami masalah dengan Redis saat ini.
• Extension:ParserFunctions - untuk templat yang terpasang secara otomatis (misal #time)

sangat disarankan

• Parsoid untuk pilihan menyimpan postingan sebagai HTML ($wgFlowContentFormat = 'html';) yang memperbagus kinerja. Ini adalah bagaimana wiki-wiki milik Yayasan Wikimedia dikonfigurasi, dan karenanya merupakan konfigurasi yang paling diuji sejauh ini. Bila Anda menggunakan MediaWiki-Vagrant, penyalaan StructuredDiscussions menyalakan Parsoid dan mengatur format menjadi 'html'.

opsional

• Ekstensi:BetaFeatures - bila Anda mau menggunakan fitur beta ikut serta untuk pembicaraan pengguna.
• Ekstensi:CLDR - untuk cap waktu yang mudah terpahami misal "3 hari yang lalu"
• Extension:VisualEditor - untuk dukungan PenyuntingVisual

  kekutu? bila Anda ada PenyuntingVisual (mungkin untuk menyediakan OOUI), maka PerbincanganTerstruktur akan mencoba menghubungi Parsoid walaupun PenyuntingVisual tak dinyalakan

• PerbincanganTerstruktur dapat berpadu dengan Pengaya:PenyaringPenyalahgunaan , Extension:SpamBlacklist , dan Extension:ConfirmEdit , lihat Extension:StructuredDiscussions/Spam
• StructuredDiscussions akan berpadu dengan Extension:CheckUser bila Anda telah memasangnya.
• Extension:Thanks - untuk "Berterima kasih" kepada pengguna atas postingan mereka

Kunjungi salah satu halaman yang Anda nyalakan untuk PerbincanganTerstruktur (lihat #Configuration) dan coba tambahkan topik serta sunting tajuknya.

Berikut beberapa pengaturan yang perlu Anda lakukan dalam LocalSettings.php.

Untuk menyalakan atau mematikan PerbincanganTerstruktur untuk suatu ruang nama di MediaWiki sebelum versi 1.35, pertama-tama jalankan populateContentModel.php pada ruang nama yang terdampak (atau Anda dapat melakukannya pada all). Dari versi 1.35 dan setelahnya, ini tak lagi dibutuhkan. Misal bila Anda akan segera menyalakan atau mematikannya pada NS_TALK (1) dan NS_USER_TALK (3) sebagaimana ditunjukkan dalam konfigurasi PHP di bawah:

mwscriptpopulateContentModel.php--wiki=somewiki--ns=1--table=revision
mwscriptpopulateContentModel.php--wiki=somewiki--ns=1--table=archive
mwscriptpopulateContentModel.php--wiki=somewiki--ns=1--table=page
mwscriptpopulateContentModel.php--wiki=somewiki--ns=3--table=revision
mwscriptpopulateContentModel.php--wiki=somewiki--ns=3--table=archive
mwscriptpopulateContentModel.php--wiki=somewiki--ns=3--table=page

Bila mwscript tidak dikonfigurasi, ganti mwscript populateContentModel.php dengan php maintenance/populateContentModel.php

Setelah langkah di atas, atur $wgNamespaceContentModels [namespace] untuk ruang nama tertentu. Contohnya:

 // Baris-baris ini menyalakan StructuredDiscussions pada ruang nama "Talk" dan "User talk"
 // Semua konstanta NS_* di sini: https://www.mediawiki.org/wiki/Manual:Namespace_constants
 $wgNamespaceContentModels[NS_TALK] = 'flow-board';
 $wgNamespacesWithSubpages[NS_TALK] = true;
 $wgNamespaceContentModels[NS_USER_TALK] = 'flow-board';
 $wgNamespacesWithSubpages[NS_USER_TALK] = true;

Jangan menetapkan ulang global ((削除) $wgNamespaceContentModels = (削除ここまで)).

Untuk menyalakannya pada suatu halaman, gunakan Special:EnableStructuredDiscussions. Ini memerlukan hak flow-create-board, yang bisa diberikan ke kelompok apa pun (lihat Manual:Hak pengguna#Mengubah izin kelompok).

 $wgGroupPermissions['somegroup']['flow-create-board'] = true;

Lihat Extension:StructuredDiscussions/Turning off all StructuredDiscussions untuk cara mematikan semua halaman PerbincanganTerstruktur pada wiki Anda.

PerbincanganTerstruktur menggunakan Jasa REST Virtual untuk menghubungi suatu jasa Parsoid atau RESTBase. Bila wiki Anda memuat pengaya VisualEditor , maka Anda mungkin sudah menyetelnya. Cari hal-hal berikut dalam LocalSettings.php Anda:

$wgVirtualRestConfig['modules']['parsoid'] = array(
 // URL ke wujud Parsoid
 // Gunakan porta 8142 bila Anda menggunakan paket Debian
 'url' => 'http://localhost:8000',
 // "Domain" Parsoid, lihat di bawah (opsional)
 'domain' => 'localhost',
 // "Awalan" Parsoid, lihat di bawah (opsional)
 'prefix' => 'localhost',
);

Satu peladen Parsoid dapat menangani beberapa wiki. Pengaturan Parsoid domain mengidentifikasi konfigurasi wiki Anda ke Parsoid. Secara bawaan ditetapkan pada nama hos yang dinamakan oleh $wgCanonicalServer, tetapi Anda dapat memilih untaian sewewang-wenang. Versi Parsoid yang lama juga menggunakan "awalan" unik untuk mengidentifikasi peladen; Anda mungkin perlu mencantumkannya di sini juga.

Parsoid harus dikonfigurasi agar sesuai, menggunakan baris di localsettings.js Parsoid macam:

parsoidConfig.setMwApi({uri:'http://path/to/my/wiki/api.php',domain:'localhost',prefix:'localhost'});

Sekali lagi, properti "domain" bersifat opsional dalam konfigurasi Parsoid; secara bawaan akan menggunakan nama hos yang digunakan dalam properti uri jika tidak ditentukan. Properti "awalan" juga dapat dihilangkan kecuali jika Anda menjalankan versi Parsoid yang lebih lama. Pastikan domain dan prefix yang tercantum di localsettings.js Parsoid sesuai dengan yang ada di LocalSettings.php wiki Anda.

Lihat Parsoid/Pengaturan#Konfigurasi untuk rincian lebih.

Bila Anda mendapatkan galat ini, Anda perlu mengatur xdebug.max_nesting_level = 200, kemungkinan di /etc/php5/apache2/php.ini.[1]

PerbincanganTerstruktur memanggil $cache->cas() dan beberapa penerapan tembolok termasuk CACHE_ACCEL (APCBagOStuff) tidak menerapkan CAS. Anda kemungkinan perlu menggunakan tembolok berbeda, contohnya memasang memcached dan mengatur $wgMainCacheType = CACHE_MEMCACHED;.

Pengguna harus mempunyai izin edit inti untuk melakukan tindakan menulis apa pun di StructuredDiscussions. Banyak wiki hanya mengabulkan izin ini ke kelompok 'user' (yang masuk log).

PerbincanganTerstruktur mendefinisikan banyak tindakan seperti edit-post dan delete-topic (lihat daftar di FlowActions.php). Izin bervariasi tergantung pada apakah postingannya milik Anda sendiri dan apakah telah dimoderasi. Contoh, secara bawaan para pengguna dapat menyunting postingan mereka sendiri, tetapi hanya para pengguna dalam kelompok 'sysop' mempunyai izin flow-edit-post untuk menyuntingan postingan siapa pun. Anda dapat mengesampingkan kelompok mana yang mempunyai izin dan izin apa yang diperlukan untuk tiap tindakan Flow; lihat Manual:Hak pengguna untuk ikhtisar tentang izin.

Untuk memigrasikan satu halaman yang ada, gunakan Special:EnableStructuredDiscussions. Akan menangani pengarsipan satu halaman (lalu menyalakan PerbincanganTerstruktur) secara otomatis.

Skrip maintenance/convertNamespaceFromWikitext.php mengotomatiskan konversi dan pengarsipan ruang nama ini, lihat Flow/Converting talk pages. Ini agak khusus ke wiki-wiki milik Yayasan Wikimedia, jadi evaluasikan pengoperasiannya dan cadangkan pangkalan data Anda sebelum menjalakankannya. Skrip lain maintenance/convertAllLqtPages.php mengonversi halaman LiquidThreads dan utasnya menjadi topik dan papan Flow, lihat Flow/Converting LiquidThreads. Peringatan serupa berlaku.

Flow menambahkan ruang nama Topic:, lihat Extension default namespaces#flow. Anda dapat mengunjungi Special:PrefixIndex/Topic: untuk melihat bila terdapat halaman yang sudah ada yang berbentrokan dengan ini; bila demikian, jalankan skrip pemeliharaan maintenance/namespaceDupes.php.

Menggunakan pilihan "Penyuntingan sumber" pada papan PerbincanganTerstruktur akan menampakkan teks bantuan "Teks wiki menggunakan markah dan Anda dapat pratayangkan hasil kapan saja.". Bagian "menggunakan markah" ditautkan melalui pesan sistem MediaWiki:Flow-wikitext-editor-help-uses-wikitext yang mempergunakan tautan antarwiki ke MediaWiki.org.

Dalam beebrapa kasus, tautan antarwiki ini, alih-alih menuju ke Help:Formatting pada MediaWiki.org, malahan menuju ke halaman Help:Formatting (yang biasanya tidak ada) pada wiki hos.

Ini dapat diralat dengan mengubah tautan antarwiki pada MediaWiki:Flow-wikitext-editor-help-uses-wikitext menjadi tautan luar macam

Flow tidak berjalan sesuai harapan? Ada beberapa perbaikan, tergantung pada sumber masalah:

Ketika Anda mendapat pesan macam Conversion from 'html' to 'wikitext' was requested, but core's Parser only supports 'wikitext' to 'html' conversion, Anda mungkin menggunakan versi MediaWiki (misal REL1_39) di mana pengaya PerbincanganTerstruktur tidak menggunakan konfigurasi nol parsoid. Untuk menggunakan penyunting visual pada perbincangan, Anda harus secara manual mengonfigurasi paarsoid-php.

For REL1_39 of MediaWiki and StructuredDiscussions, be sure to do all of the following:

1. wfLoadExtension('Flow');
   

2. wfLoadExtension ('Parsoid', "$IP/vendor/wikimedia/parsoid/extension.json" );
   

3. Set

   $wgVirtualRestConfig['modules']['parsoid']
   

   appropriately. See example.

Older versions of MediaWiki may need Parsoid-JS and perhaps a code patch:

1. Pastikan Anda telah memasang parsoid dengan benar.
2. Ketika kekutu ini belum teratasi, terapkan tambalan ini ke pangkalan kode PerbincanganTerstruktur.

If the problem persists, this discussion might be of some help.

Deklarasi Flow harus ditempatkan "setelah" deklarasi untuk ruang nama kustom. Urutan yang benar yaitu:

define("NS_PORTAL_TALK", 3005);
$wgExtraNamespaces[NS_PORTAL_TALK] = "Portal_Talk";
$wgNamespaceContentModels[NS_PORTAL_TALK] = 'flow-board';
$wgNamespacesWithSubpages[NS_PORTAL_TALK] = true;

Halaman pembicaraan di ruang nama Utama didefinisikan sebagai NS_TALK , bukan NS_MAIN_TALK

Deklarasi yang benar yaitu:

$wgNamespaceContentModels[NS_TALK] = 'flow-board';

Konstanta ruang nama Extension:Page Forms seharusnya berupa PF_NS_FORM_TALK. Namun konstanta itu tidak bekerja dalam deklarasi Flow-- Anda harus menggunakan bilangan sebenarnya: 107. Ini bekerja:

$wgNamespaceContentModels[107] = 'flow-board';

Pengarang ini tidak mengetahui apakah Page_Forms gagal mendaftarkan konstantanya dengan benar, atau apakah semua pengaya harus menggunakan bilangan (bukan konstanta) dengan Flow. Lihat daftar beberapa konstanta ruang nama pengaya lainnya.

Jika Anda mendapatkan Flow dengan benar di semua halaman pembicaraan dalam sebuah ruang nama, kecuali untuk satu halaman di ruang nama tersebut, mungkin ada sisa sampah di halaman pembicaraan tersebut (meskipun tampak kosong). Lakukan yang berikut:

1. Buka halaman pembicaraan yang tidak dapat dimuat di Flow, misalnya: Portal_Talk:Welcome
2. Hapus halaman Pembicaraan menggunakan tab Hapus.
3. Buka halaman konten untuk halaman pembicaraan tersebut, misalnya: Portal:Welcome
4. Tekan Diskusikan.
5. Anda mendapatkan Flow.

To get Parsoid to work with StructuredDiscussions (Flow):

1. In LocalSettings.php, explicitely load Parsoid like so: wfLoadExtension( 'Parsoid', "vendor/wikimedia/parsoid/extension.json" );
2. Apply the following patch.

For more details, see Extension talk:StructuredDiscussions/2022#h-VisualEditor does not work on Flow (Structured discussions) talk pages.-20221212122400.

Lihat Flow/Architecture.

Lihat Extension:StructuredDiscussions/Spam untuk informasi lebih tentang cara memerangi spam di Flow.

Lihat Extension:StructuredDiscussions/Moderation untuk informasi lebih tentang moderasi di Flow.

Ada skrip pemeliharaan untuk mengekspor data Flow mirip dengan Manual:DumpBackup.php

php extensions/Flow/maintenance/dumpBackup.php

T114703 - memberikan beberapa petunjuk tentang impor.

• Unmaintained extensions/id
• Page action extensions/id
• AbuseFilter-builder extensions/id
• AbuseFilter-computeVariable extensions/id
• AbuseFilter-deprecatedVariables extensions/id
• AbuseFilterGenerateVarsForRecentChange extensions/id
• ApiFeedContributions::feedItem extensions/id
• Article::MissingArticleConditions extensions/id
• ArticleConfirmDelete extensions/id
• ArticleDelete extensions/id
• ArticleDeleteComplete extensions/id
• ArticleEditUpdateNewTalk extensions/id
• ArticleUndelete extensions/id
• BeforeCreateEchoEvent extensions/id
• BeforeDisplayOrangeAlert extensions/id
• BeforeEchoEventInsert extensions/id
• BeforePageDisplay extensions/id
• CategoryViewer::doCategoryQuery extensions/id
• CategoryViewer::generateLink extensions/id
• ChangesListInitRows extensions/id
• ChangesListInsertArticleLink extensions/id
• ChangesListSpecialPageQuery extensions/id
• CheckUserFormatRow extensions/id
• CheckUserInsertChangesRow extensions/id
• ContribsPager::reallyDoQuery extensions/id
• ContributionsLineEnding extensions/id
• DeletedContribsPager::reallyDoQuery extensions/id
• DeletedContributionsLineEnding extensions/id
• EchoAbortEmailNotification extensions/id
• EchoGetBundleRules extensions/id
• EnhancedChangesList::getLogText extensions/id
• EnhancedChangesListModifyBlockLineData extensions/id
• EnhancedChangesListModifyLineData extensions/id
• GetBetaFeaturePreferences extensions/id
• GetPreferences extensions/id
• IRCLineURL extensions/id
• ImportHandleToplevelXMLTag extensions/id
• InfoAction extensions/id
• LiquidThreadsIsLqtPage extensions/id
• LoadExtensionSchemaUpdates extensions/id
• MergeAccountFromTo extensions/id
• MovePageCheckPermissions extensions/id
• MovePageIsValidMove extensions/id
• NukeDeletePage extensions/id
• NukeGetNewPages extensions/id
• OldChangesListRecentChangesLine extensions/id
• PageMoveCompleting extensions/id
• ResourceLoaderGetConfigVars extensions/id
• ResourceLoaderRegisterModules extensions/id
• RevisionUndeleted extensions/id
• SaveUserOptions extensions/id
• SearchableNamespaces extensions/id
• ShowMissingArticle extensions/id
• SkinTemplateNavigation::Universal extensions/id
• SpecialCheckUserGetLinksFromRow extensions/id
• TitleMoveStarting extensions/id
• TitleSquidURLs extensions/id
• UnwatchArticle extensions/id
• UserGetReservedNames extensions/id
• UserMergeAccountFields extensions/id
• WatchArticle extensions/id
• WatchlistEditorBeforeFormRender extensions/id
• WatchlistEditorBuildRemoveLine extensions/id
• GetUserPermissionsErrors extensions/id
• GPL licensed extensions/id
• Extensions in Wikimedia version control/id
• All extensions/id
• Extensions incompatible with temporary accounts
• Extensions requiring Composer with git/id
• Outdated pages/id
• Extensions used on Wikimedia/id
• Structured Discussions/id
• Discussion and forum extensions/id
• Extensions with VisualEditor support/id

• Extensions with manual MediaWiki version/id