Extension:VEForAll

Ekstensi MediaWiki

VEForAll Status rilis stabil
Deskripsi	Menetapkan fungsionalitas JavaScript untuk membolehkan ekstensi lain memasukkan VisualEditor ke dalam area teks mereka
Perancang awal	Pierre Boutet, Clément Flipo, Ike Hecht, Yaron Koren and Cindy Cicalese
Versi terbaru	0.6 (Desember 2024)
Kebijakan kompatibilitas	Master maintains backward compatibility.
MediaWiki	1.39+
Perubahan basis data	Tidak
Lisensi	Lisensi Publik Umum GNU 2.0 atau lebih baru
Unduh	Unduh ekstensi Git [?]: Unduh master Git telusuri repositori (Phabricator · GitHub) riwayat commit kontributor repositori (GitHub) peninjauan kode
Hooks used BeforePageDisplay MakeGlobalVariablesScript
Hooks provided VEForAllToolbarConfigNormal
Quarterly downloads	4 (Ranked 132nd)
Terjemahkan ekstensi VEForAll jika tersedia di translatewiki.net
Masalah	Tugas terbuka · Laporkan kekutu

The VEForAll ("VisualEditor For All") extension allows other extensions to incorporate the VisualEditor interface into textareas for user editing.

This extension does not directly impact the user interface. Rather, it defines a JavaScript function (called "applyVisualEditor()") that can be called by other extensions on their textareas. At the moment, the following extensions can make use of VEForAll:

• CommentStreams
• Page Forms
• FlexForm
• VisualData

As might be expected, the VisualEditor extension must be installed for this extension to work.

Pengunduhan

You can download the VEForAll code, in .zip format, here.

You can also download the code directly via Git from the MediaWiki source code repository. From a command line, you can call the following:

git clone https://gerrit.wikimedia.org/r/mediawiki/extensions/VEForAll

You can also view the code online here.

Pemasangan

To install this extension, create a 'VEForAll' directory (either by extracting a compressed file or downloading via Git), and place this directory within the main MediaWiki 'extensions' directory. Then, in the file 'LocalSettings.php', add the following line:

wfLoadExtension( 'VEForAll' );

Menggunakan VEForAll dengan ekstensi lain

VEForAll can currently be used with the following extensions: CommentStreams , Page Forms , FlexForm , VisualData

• For CommentStreams, you simply need to have VEForAll (and VisualEditor) installed, and then textareas for entering comments will automatically get the VisualEditor interface.
• For Page Forms, in the form definition, add |editor=visualeditor to the tag for any textarea input (including the "free text" input), and the VisualEditor interface should show up when viewing that form.
• For FlexForm, use editor="ve" when defining a textarea, e.g. <_input type="textarea" editor="ve"></_input>. You can have as many VE editors on a page as needed and you can even add a menu/button to the VE Editor that will open another VE Editor.
• For VisualData, VEForAll is enabled by default in the form for creating a new article, and can be enabled through the Schema Builder in any input with type string and format textarea.

Konfigurasi

By default, the toolbar is display at the bottom of the textarea. In Page Forms, you can instead display it at the top by adding |class=toolbarOnTop to the textarea's tag in the form definition.

You can use the "VEForAllToolbarConfigNormal" and "VEForAllToolbarConfigWide" hooks to customize the display of the VisualEditor toolbar. One or the other hook is called, depending on whether "toolbarOnTop" is set: "Normal" is called if it is not set, and "Wide" if it is.

For example, to add buttons for "Insert > Math formula", "Insert > Images and media", and "Cite" in the normal (toolbar on the bottom) case, add the following to LocalSettings.php, below the inclusion of VEForAll:

$wgHooks['VEForAllToolbarConfigNormal'][] = function( &$defaultConfigNormal ) {
        $defaultConfigNormal[4]['include'][] = 'math';
        $defaultConfigNormal[4]['include'][] = 'media';
        $defaultConfigNormal[] = [ 'name' => 'reference' ];
};

For the first and third lines to have an effect, the Math and Cite extensions must be installed, respectively.

Known issues

In some skins, the dropdowns may look rather compressed. You can apply a small CSS tweak to fix this:

table.formtable,
table.multipleTemplateInstanceTable {
  border-collapse: inherit;
}

Penulis dan kredit

VEForAll is heavily based on the (now-obsolete) VEForPageForm extension by Pierre Boutet and Clément Flipo. Some work to make the code more generic was done by Ike Hecht, Yaron Koren and Cindy Cicalese. Others who contributed to the code include Anysite and Mark Hershberger. VEForAll also includes code from the StructuredDiscussions extension.

Riwayat versi

• 0.1 - 3 Mei 2018 - Initial version
• 0.2 - 7 Februari 2020 - Made toolbar configurable; removed dependency on the Math extension; fixed submitting values for "focused" textareas; set VE direction (RTL/LTR) correctly; added "veForAll.targetCreated" hook; many other fixes
• 0.3 - 5 Mei 2021 - Improved support for MW 1.35+; removed support for MW < 1.29; added handling for Page Forms "max height" parameter; added escaping of pipes in table wikitext within Page Forms template fields; bug fixes
• 0.4 - 3 November 2021 - Improved support for MW 1.34+; removed support for MW < 1.32; fixes for pipe escaping
• 0.4.1 - 15 November 2022 - Fixed support for MW 1.39+; other fixes
• 0.5 - 22 Maret 2023 - Further fix for support for MW 1.39+; removed support for MW < 1.35
• 0.5.1 - 2 Agustus 2023 - Fixed Parsoid handling for MW 1.40+; fixed handling of "rowspan" and "colspan" attributes; updated hook handling
• 0.5.2 - 20 Februari 2024 - Improved support for MW 1.41+; fix for rapid conversion between wikitext and HTML
• 0.6 - 4 Desember 2024 - Removed support for MW < 1.39; removed requirement for "visualeditor-enable" preference; fix for "toolbar on top" positioning