افزونه: ابزارهای بحث و گفتگو

**راهنمای افزونهٔ مدیاویکی**
DiscussionTools; وضعیت انتشار: پایدار
انجام	رابط کاربری
توضیحات	ابزارهایی برای بهبود صفحات بحث
نویسنده(گان)	ویکی‌مدیا تیم ویرایش
آخرین نسخه:	به‌روزرسانی مداوم
سیاست سازگاری	Snapshots releases along with MediaWiki. Master is not backward compatible.
تغییر پایگاه داده	بله
جدول‌ها	discussiontools_items; discussiontools_item_ids; discussiontools_item_pages; discussiontools_item_revisions; discussiontools_subscription
مجوز	MIT License
بارگیری	Download extension ; Git [?]: Browse repository (Phabricator · GitHub); Gerrit code review; Git commit log; Download source tarball;
راهنما	Help:DiscussionTools
	پارامترها $wgDiscussionToolsReplyIndentation; $wgDiscussionToolsBeta; $wgDiscussionTools_visualenhancements; $wgDiscussionToolsEnablePermalinksBackend; $wgDiscussionToolsEnableThanks; $wgDiscussionToolsTimestampFormatSwitchTime; $wgDiscussionToolsShowFeedbackLinks; $wgDiscussionToolsTalkPageParserCacheExpiry; $wgDiscussionTools_visualenhancements_pageframe; $wgDiscussionToolsAutoTopicSubEditor; $wgDiscussionToolsConflictingGadgetName; $wgDiscussionTools_visualenhancements_reply; $wgDiscussionToolsEnablePermalinksFrontend; $wgDiscussionTools_visualenhancements_reply_icon_languages;
	Hooks used ApiMain::moduleManager; BeforeCreateEchoEvent; BeforeDisplayNoArticleText; BeforePageDisplay; ChangeTagsListActive; DiscussionToolsAddOverflowMenuItems; EchoGetBundleRules; EchoGetEventsForRevision; GetActionName; GetBetaFeaturePreferences; GetDoubleUnderscoreIDs; GetPreferences; ListDefinedTags; LoadExtensionSchemaUpdates; OutputPageBeforeHTML; OutputPageParserOutput; ParserAfterTidy; ParserOutputPostCacheTransform; RecentChange_save; ResourceLoaderGetConfigVars; RevisionDataUpdates; SidebarBeforeOutput; SkinTemplateNavigation::Universal;
	Hooks provided DiscussionToolsAddOverflowMenuItems; DiscussionToolsTermsOfUseMessages;
	Translate the DiscussionTools extension
Issues	Open tasks · گزارش یک مشکل

This page is a translated version of the page Extension:DiscussionTools and the translation is 45% complete.

Outdated translations are marked like this.

افزونه Discussion Tools مجموعه‌ای از ابزارها برای بهبود صفحات بحث است. Template:از، توسط تیم ویرایش به عنوان بخشی از پروژه صفحات گفتگو در حال ساخت است.

مستندات کاربر در Help:DiscussionTools است

برخی از ویژگی‌ها را می‌توان در صفحات و بخش‌های جداگانه غیرفعال کرد، همانطور که در Help:DiscussionTools/Magic words and markup توضیح داده شده است.

ویژگی‌ها

وابستگی‌ها

Optional dependencies

افزونه: اکو - همچنین اگر می‌خواهید از ویژگی اشتراک‌های موضوع استفاده کنید، $1 لازم است.
Extension:Thanks - Enables comment thanking.
Extension:MobileFrontend - Enables mobile support.

راه‌اندازی

This extension comes with MediaWiki 1.40 and later, so you do not need to download it. The remaining configuration instructions must still be followed.

Install the dependencies.
Download and move the extracted DiscussionTools folder to your extensions/ directory.
Developers and code contributors should install the extension from Git instead, using:
```
cd extensions/
git clone https://gerrit.wikimedia.org/r/mediawiki/extensions/DiscussionTools
```
کد زیر را در انتهای $LocalSettings خودتان اضافه کنید:
```
wfLoadExtension( 'DiscussionTools' );
```
اسکریپت به‌روزرسانی اجرا کنید تا به طور خودکار جدول‌های پایگاه داده‌ها ضروری که این افزونه نیازمند دارد را ایجاد کند.
همچنین در LocalSettings.php، مطمئن شوید که یک مجموعه زمان زمانی و مجموعه $wgFragmentMode در html5 دارید.
Configure as required.
انجام شد – به Special:Version در ویکی خودتان بروید تا مطئمن شوید که افزونه با موفقیت نصب شده است.

پیکربندی

نام تنظیمات	مقدار پیش‌فرض	توضیحات
`$wgDiscussionToolsBeta`	`false`	ابزارهای بحث و گفتگو را به یک ویژگی بتا تبدیل کنید.
`$wgDiscussionTools_visualenhancements`	`'default'`	Override availability of DiscussionTools visual enhancements. Possible values: `'default'`, `'available'`, `'unavailable'`
`$wgDiscussionTools_visualenhancements_reply_icon_languages`	[ 'ar' => true, 'zh' => true, 'yue' => true, 'ja' => true, 'nod' => true, ]	A dictionary of language codes which will receive an icon in their enhanced reply-button treatment, due to translation being very short. (T323537) Language fallbacks will be checked unless a language is explicitly set to `false`. (T352289) Normalized language codes are lower case.
`$wgDiscussionToolsAutoTopicSubEditor`	`'any'`	Editor which triggers automatic topic subscriptions. Either `'discussiontoolsapi'` for edits made using DiscussionTools’ API (e.g. reply and new topic tools), or `'any'` for any editor.
`$wgDiscussionToolsTalkPageParserCacheExpiry`	`0`	Override `$wgParserCacheExpireTime` for discussion pages, regardless of DiscussionTools enablement.
`$wgDiscussionToolsReplyIndentation`	`'invisible'`	برای استفاده از دستور تورفتگی پاسخ دهید: `'invisible'` (از تگ های `<dl><dd>` برای خروجی `:` در ویکی متن استفاده کنید) یا `'bullet'` (از تگ های `<ul><li>` برای خروجی `*` در ویکی متن استفاده کنید).
`$wgDiscussionToolsShowFeedbackLinks`	`false`	MW 1.40+ پیوندهای «به اشتراک گذاری بازخورد در خصوص این ویژگی» را در پاورقی ابزار پاسخ و ابزار موضوع جدید نشان دهید.
`$wgDiscussionToolsTimestampFormatSwitchTime`	`'2022-07-12'`	Date on which the internal timestamp format has changed (T304595), in ISO 8601 format.
`$wgDiscussionToolsConflictingGadgetName`	`'convenientDiscussions'`	نام داخلی ابزار Convenient Discussions که با ابزار پاسخ مغایرت دارد وقتی کاربر این ابزار را فعال کرده باشد، ابزار پاسخ در دسترس نخواهد بود.

API

Editing


Action	Description	Internal?
discussiontoolscompare	Get information about comment changes between two page revisions.
discussiontoolsedit	فرستادن یک نظر در یک صفحهٔ بحث.	N
discussiontoolsfindcomment	Find a comment by its ID or name.	N
discussiontoolspageinfo	فرادادهٔ مورد نیاز برای راه‌اندازی ابزارهای گفت‌وگو را برمی‌گرداند
discussiontoolspreview	پیش‌نمایش یک پیام در یک صفحهٔ گفتگو

Subscriptions

Action	Description	Internal?
discussiontoolsgetsubscriptions	دریافت وضعیت اشتراک مبحث‌های مشخص‌شده.	N
discussiontoolssubscribe	اشتراک (یا لغو اشتراک) برای دریافت آگاه‌سازی‌ها دربارهٔ یک مبحث.	N

Special pages

ادغام با سایر افزونه‌ها

DiscussionTools می تواند با PlaceNewSection ادغام شود تا محل قرارگیری موضوع جدید اضافه شده را قرار دهد.

It can also integrate with AutoModerator to enable community-configured reversion of Machine Language-scored bad edits.

همچنین ببینید

Extension:DiscussionTools/How it works – اطلاعات فنی
Convenient Discussions – another tool for discussions, incompatible with DiscussionTools

این افزونه در یکی یا بیشتر پروژه‌های ویکی‌مدیا استفاده شده است. این احتمالاً به این معنی است که افزونه پایدار است و به اندازه کافی برای استفاده توسط وبسایت‌های ترافیک-بالا به خوبی کار می‌کند. برای نام این افزونه در پرونده‌های پیکربندی CommonSettings.php و InitialiseSettings.php ویکی‌مدیا بگردید تا جایی که آنها نصب شده را ببینید. یک فهرست کامل از افزونه‌ها نصب‌شده روی یک ویکی مشخص را می‌توان در صفحۀ Special:Version دید.

This extension is included in the following wiki farms/hosts and/or packages:

This is not an authoritative list. Some wiki farms/hosts and/or packages may contain this extension even if they are not listed here. Always check with your wiki farms/hosts or bundle to confirm.