手冊:強制預覽

強制預覽(Force preview) 是一個能使特定的人或用戶組別於保存頁面之前必須至少預覽頁面至少一次的JavaScript。

欲使用此程式碼，請將其導入至個別維基的 MediaWiki:Common.js 頁面。

注意這個方法並非完全萬無一失。 如果該用戶於瀏覽器關閉JavaScript功能，此強制預覽功能是不會運作的。 如果您想要確保這個方針是強制執行的，那麼您應該查看 扩展:强制预览 。

NOTE: some of these scripts are outdated and use addOnloadHook that is deprecated.

对于MediaWiki 1.23或更新版本

// 强制预览和填写编辑摘要 - 开始
if (mw.config.get("wgAction") === "edit")
	$.when(mw.loader.using("user.options"), $.ready).then(function () {
		var $wpSave = $("#wpSave"),
			$wpPreview = $("#wpPreview"),
			saveVal = $wpSave.val(),
			classNames = "oo-ui-widget-enabled oo-ui-flaggedElement-progressive oo-ui-flaggedElement-primary";
		if (!mw.user.options.get("forceeditsummary") || mw.user.options.get("previewonfirst"))
			mw.loader.using("mediawiki.api", function () {
				new mw.Api().saveOptions({forceeditsummary: 1, previewonfirst: 0});
			});
		if (!$("#wikiPreview,#wikiDiff").is(":visible") && $wpSave.length && $wpPreview.length) {
			$wpSave.prop("disabled", true)
				.val("Save page (use preview first)")
				.parent().removeClass(classNames).addClass("oo-ui-widget-disabled");
			$wpPreview.one("click", function (e) { // 再次启用
				$wpSave.prop("disabled", false)
					.val(saveVal)
					.parent().removeClass("oo-ui-widget-disabled").addClass(classNames);
			}).parent().addClass(classNames);
		}
	});
// 强制预览和填写编辑摘要 - 结束

對於 MediaWiki 1.17 或更新版本

Not right working with LivePreview (v.1.17) and OOUI (v.1.23).

// -------------------------------------------------------------------------------
//  強制預覽 JavaScript功能 - 開始
//
//  為了允許任何組別繞過強制預覽功能
//  於 permittedGroups 欄輸入組別名稱
//  例如：
//    var permittedGroups = [];                       // 強制每個人
//    var permittedGroups = [ "user"];                // 允許登錄帳戶
//    var permittedGroups = [ "sysop", "bureaucrat"]; // 允許管理員、行政员
// -------------------------------------------------------------------------------
var permittedGroups = [];

function forcePreview() {
	if ( mw.config.get( "wgAction" ) !== "edit" ) return;
	if ( mw.config.get( "wgUserGroups" ).filter(function(group) {
		return permittedGroups.indexOf(group) > -1;
	}).length ) return;
	var saveButton = document.getElementById( "wpSave" );
	if ( !saveButton ) return;
	saveButton.disabled = true;
	saveButton.value = "Save page (use preview first)";
	saveButton.style.fontWeight = "normal";
	document.getElementById("wpPreview").style.fontWeight = "bold";
}

jQuery(document).ready( forcePreview );
// -----------------------------------------------------
//  強制預覽 JavaScript功能 - 結束
// -----------------------------------------------------

對於Mediawiki 1.14或更新版本

以下會允許您可以控制特定用戶必須強制執行預覽模式。 它允許您設置一個或多個用戶組以直接保存頁面而繞過強制預覽功能。 為了允許用戶組別，於permittedGroups欄添加組別名稱，如以下JavaScroup程式碼的註解欄所示

// -------------------------------------------------------------------------------
//  強制預覽 JavaScript功能 - 開始
//
//  為了允許任何組別繞過強制預覽功能
//  於 permittedGroups 欄輸入組別名稱
//  例如：
//    var permittedGroups = [];                       // 強制每個人
//    var permittedGroups = [ "user"];                // 允許登錄帳戶
//    var permittedGroups = [ "sysop", "bureaucrat"]; // 允許管理員、行政员
// -------------------------------------------------------------------------------
var permittedGroups = [];

function forcePreview()
{
  if( wgAction !== "edit") return;
  if( wgUserGroups === null) {
    wgUserGroups = [];
  }
  if( wgUserGroups.filter(function(group) {
    return permittedGroups.indexOf(group) > -1;
  }).length ) {
    return;
  }
  var saveButton = document.getElementById("wpSave");
  if( !saveButton )
    return;
  saveButton.disabled = true;
  saveButton.value = "Save page (use preview first)";
  saveButton.style.fontWeight = "normal";
  document.getElementById("wpPreview").style.fontWeight = "bold";
}

addOnloadHook(forcePreview);
// -----------------------------------------------------
//  強制預覽 JavaScript功能 - 結束
// -----------------------------------------------------

較舊的版本

以下腳本是根據由 fr.wikipedia.org Marc Mongenet的腳本。

使 wgUserGroups 強制預覽， MW版本需 >= 1.10

function forcePreview() {
  if (wgUserGroups === "user" || wgAction !== "edit") return;
  saveButton = document.getElementById("wpSave");
  if (!saveButton) return;
  saveButton.disabled = true;
  saveButton.value = "Save page (use preview first)";
  saveButton.style.fontWeight = "normal";
  document.getElementById("wpPreview").style.fontWeight = "bold";
}
addOnloadHook(forcePreview);

如果您想要排除特定的用戶組別。僅需更改 === (EQUAL TO) 符號至 !== (NOT EQUAL TO)

  if (wgUserGroups !== "user" || wgAction !== "edit") return;

常見的由 "用戶", "行政员", "管理員" 等等選定範圍是取決於您的配置方式。

Marc Mongenet的強制執行功能， 由 wgUserName, MW版本需 > 1.6

/* 使匿名用戶強制預覽 */
/* 由fr.wikipedia, Marc Mongenet, 2006 */

function forcePreview() {
  if (wgUserName !== null || wgAction !== "edit") return;
  saveButton = document.getElementById("wpSave");
  if (!saveButton) return;
  saveButton.disabled = true;
  saveButton.value = "Save page (use preview first)";
  saveButton.style.fontWeight = "normal";
  document.getElementById("wpPreview").style.fontWeight = "bold";
}
addOnloadHook(forcePreview);

/* 強制執行功能結束 */

參見

• Manual:常见问题解答
• 扩展:强制预览 - 一個執行相同功能的Media擴展功能，無法透過關閉JavaScript繞過。