وحدة:Message box/ملعب
هذه صفحة ملعب الوحدة لصفحة وحدة:Message box (فرق). |
صُنّفت هذه الوحدة على أنها محمية. تصل الوحدة لهذه المرحلة عندما تستخدم في صفحات كثيرة جدًا. فيجب أن تحمى بسبب أن عمليات التخريب أو الأخطاء تطال الكثير من الصفحات. كما هناك تعديلات غير مجدية تتم على هذه الوحدات تكون عبارة عن حركات صبيانية تسبب تعب للخادم. |
هذه الوحدة مستخدمة في عدد كبير من الصفحات (+1705563) . لتفادي خلق بلبلة على نطاق واسع من الصفحات وزيادة الأعباء على الخوادم، يجب تجربة أي تعديل في هذه الصفحات الفرعية /ملعب أو /تجربة أو في ملعبك. بعدها يمكنك اضافة التعديلات دفعة واحدة، ورجاءً، لا تنسَ مناقشة أمر التعديلات أوّلًا قبل القيام بها. |
هذه الوحدة تعتمد على الوحدات الأخرى التالية: |
هذه الوحدة تستخدم أنماط القوالب: |
هذه وحدة ميتا التي تنفذ قوالب صندوق الرسائل {{mbox}}، {{ambox}}، {{cmbox}}، {{fmbox}}، {{imbox}}، {{ombox}}، و{{tmbox}}. إنها مخصصة للاستخدام من وحدات Lua، ويجب عدم استخدامها مباشرة من صفحات الويكي. إذا كنت ترغب في استخدام وظائف هذه الوحدة من صفحة ويكي، يرجى استخدام قوالب صندوق الرسائل الفردية بدلاً من ذلك.
الاستخدام
عدللاستخدام هذه الوحدة من وحدة لوا أخرى، تحتاج أولاً إلى تحميلها.
local messageBox = require('Module:Message box')
لإنشاء صندوق رسالة، استخدم وظيفة main
. تأخذ هذه الوظيفة معلمين: الأول هو نوع الصندوق (كنص)، والثاني هو جدول يحتوي على معلمات صندوق الرسائل.
local box = messageBox.main( boxType, {
param1 = param1,
param2 = param2,
-- مزيد من المعلمات...
})
توجد سبعة أنواع متاحة من الصناديق:
نوع الصندوق | القالب | الغرض |
---|---|---|
mbox |
{{صندوق رسالة نطاق}} | للصناديق التي تُستخدم في عدة نطاقات |
ambox |
{{صندوق رسالة مقالة}} | لصناديق رسائل المقالات |
cmbox |
{{صندوق رسالة تصنيف}} | لصناديق رسائل التصنيفات |
fmbox |
{{صندوق رسالة تبصرة}} | لصناديق رسائل الواجهات |
imbox |
{{صندوق رسالة ملف}} | لصناديق رسائل نطاق الملفات |
tmbox |
{{صندوق رسالة نقاش}} | لصناديق رسائل صفحات النقاش |
ombox |
{{صندوق رسالة أخرى}} | لصناديق الرسائل في نطاقات أخرى |
راجع صفحة القالب لكل نوع صندوق لمعرفة المعلمات المتاحة.
الاستخدام من #invoke
عدلبجانب وظيفة main
، تحتوي هذه الوحدة على وظائف منفصلة لكل نوع صندوق. يتم الوصول إليها باستخدام الشيفرة {{#invoke:Message box|mbox|...}}
، {{#invoke:Message box|ambox|...}}
، إلخ. ستعمل هذه الوظائف عند استدعائها من وحدات أخرى، لكنها تستخدم الشيفرة المخصصة لمعالجة المعلمات المرسلة من #invoke، لذا فإن استدعاءها سيكون أقل كفاءة من استدعاء main
.
التفاصيل التقنية
عدلتستخدم الوحدة نفس الشيفرة الأساسية لكل من القوالب المذكورة أعلاه؛ تختلف بين كل منها باستخدام البيانات في وحدة:Message box/configuration. فيما يلي خيارات التكوين المختلفة وما تعنيه:
types
– جدول يحتوي على بيانات تُستخدم بواسطة معلمة النوع في صندوق الرسائل. مفاتيح الجدول هي القيم التي يمكن تمريرها إلى معلمة النوع، وقيم الجدول هي جداول تحتوي على الفئة والصورة المستخدمة من قبل هذا النوع.default
– النوع الذي يجب استخدامه إذا لم يتم تمرير قيمة إلى معلمة النوع، أو إذا تم تحديد قيمة غير صالحة.showInvalidTypeError
– ما إذا كان يجب عرض خطأ إذا كانت القيمة المرسلة إلى معلمة النوع غير صالحة.allowBlankParams
– عادةً ما يتم حذف القيم الفارغة من المعلمات المرسلة إلى الوحدة. ومع ذلك، يتم الحفاظ على المسافات البيضاء للمعلمات المدرجة في جدول allowBlankParams.allowSmall
– ما إذا كان يمكن إنتاج نسخة صغيرة من صندوق الرسائل باستخدام "small=yes".smallParam
– اسم مخصص لمعلمة الصغير. على سبيل المثال، إذا تم تعيينه إلى "left" يمكنك إنتاج صندوق رسالة صغير باستخدام "small=left".smallClass
– الفئة التي يجب استخدامها لصناديق الرسائل الصغيرة.substCheck
– ما إذا كان يجب إجراء تحقق من الاستبدال أم لا.classes
– مصفوفة من الفئات التي يجب استخدامها مع صندوق الرسائل.imageEmptyCell
– ما إذا كان يجب استخدام خلية<td></td>
فارغة إذا لم يتم تعيين صورة. يُستخدم ذلك للحفاظ على المسافات لصناديق الرسائل التي عرضها أقل من 100% من الشاشة.imageEmptyCellStyle
– ما إذا كان يجب تنسيق خلايا الصور الفارغة.imageCheckBlank
– ما إذا كانت "image=blank" تؤدي إلى عدم عرض أي صورة.imageSmallSize
– عادةً ما يتم تعيين الصور المستخدمة في صناديق الرسائل الصغيرة إلى 30x30 بكسل. يقوم هذا بتعيين حجم مخصص.imageCellDiv
– ما إذا كان يجب تضمين الصورة في div يفرض حجمًا أقصى للصورة.useCollapsibleTextFields
– ما إذا كان يجب استخدام حقول نصية يمكن طيها، مثل "issue"، "fix"، "talk"، إلخ. حاليًا، تُستخدم فقط في ambox.imageRightNone
– ما إذا كانت imageright=none تؤدي إلى عدم عرض أي صورة على الجانب الأيمن من صندوق الرسائل.sectionDefault
– الاسم الافتراضي لمعلمة "section". يعتمد علىuseCollapsibleTextFields
.allowMainspaceCategories
– السماح بالتصنيف في النطاق الرئيسي.templateCategory
– اسم الفئة التي يجب وضعها على صفحة القالب.templateCategoryRequireName
– ما إذا كانت معلمةname
مطلوبة لعرض فئة القالب.templateErrorCategory
– اسم فئة الخطأ التي يجب استخدامها على صفحة القالب.templateErrorParamsToCheck
– مصفوفة من أسماء المعلمات التي يجب التحقق منها. إذا كانت أي منها مفقودة، يتم تطبيقtemplateErrorCategory
على صفحة القالب.
require('strict')
local getArgs
local yesno = require('Module:Yesno')
local lang = mw.language.getContentLanguage()
local CONFIG_MODULE = 'Module:Message box/configuration'
local DEMOSPACES = {talk = 'tmbox', image = 'imbox', file = 'imbox', category = 'cmbox', article = 'ambox', main = 'ambox'}
--------------------------------------------------------------------------------
-- وظائف المساعدة
--------------------------------------------------------------------------------
local function getTitleObject(...)
-- الحصول على كائن العنوان، تمرير الدالة من خلال pcall
-- في حال تجاوزنا حد عدد الدوال المكلفة.
local success, title = pcall(mw.title.new, ...)
if success then
return title
end
end
local function union(t1, t2)
-- يعيد اتحاد مصفوفتين.
local vals = {}
for i, v in ipairs(t1) do
vals[v] = true
end
for i, v in ipairs(t2) do
vals[v] = true
end
local ret = {}
for k in pairs(vals) do
table.insert(ret, k)
end
table.sort(ret)
return ret
end
local function getArgNums(args, prefix)
local nums = {}
for k, v in pairs(args) do
local num = mw.ustring.match(tostring(k), '^' .. prefix .. '([1-9]%d*)$')
if num then
table.insert(nums, tonumber(num))
end
end
table.sort(nums)
return nums
end
--------------------------------------------------------------------------------
-- تعريف فئة الصندوق
--------------------------------------------------------------------------------
local MessageBox = {}
MessageBox.__index = MessageBox
function MessageBox.new(boxType, args, cfg)
args = args or {}
local obj = {}
-- تعيين كائن العنوان والفضاء الاسمي.
obj.title = getTitleObject(args.page) or mw.title.getCurrentTitle()
-- تعيين الإعدادات لنوع الصندوق لدينا.
obj.cfg = cfg[boxType]
if not obj.cfg then
local ns = obj.title.namespace
if args.demospace and args.demospace ~= '' then
-- تنفيذ معلمة demospace لـ mbox
local demospace = string.lower(args.demospace)
if DEMOSPACES[demospace] then
obj.cfg = cfg[DEMOSPACES[demospace]]
elseif string.find(demospace, 'نقاش') then
-- العرض كصفحة نقاش
obj.cfg = cfg.tmbox
else
-- افتراضيًا إلى ombox
obj.cfg = cfg.ombox
end
elseif ns == 0 then
obj.cfg = cfg.ambox -- الفضاء الاسمي الرئيسي
elseif ns == 6 then
obj.cfg = cfg.imbox -- فضاء الملفات
elseif ns == 14 then
obj.cfg = cfg.cmbox -- فضاء الفئات
else
local nsTable = mw.site.namespaces[ns]
if nsTable and nsTable.isTalk then
obj.cfg = cfg.tmbox -- أي فضاء نقاش
else
obj.cfg = cfg.ombox -- فضاءات أخرى أو مدخلات غير صالحة
end
end
end
-- تعيين المعلمات، وإزالة جميع المعلمات الفارغة باستثناء تلك الموجودة في cfg.allowBlankParams.
do
local newArgs = {}
for k, v in pairs(args) do
if v ~= '' then
newArgs[k] = v
end
end
for i, param in ipairs(obj.cfg.allowBlankParams or {}) do
newArgs[param] = args[param]
end
obj.args = newArgs
end
-- تعريف الهيكل الداخلي للبيانات.
obj.categories = {}
obj.classes = {}
obj.hasCategories = false
return setmetatable(obj, MessageBox)
end
function MessageBox:addCat(ns, cat, sort)
if not cat then
return nil
end
if sort then
cat = string.format('[[تصنيف:%s|%s]]', cat, sort)
else
cat = string.format('[[تصنيف:%s]]', cat)
end
self.hasCategories = true
self.categories[ns] = self.categories[ns] or {}
table.insert(self.categories[ns], cat)
end
function MessageBox:addClass(class)
if not class then
return nil
end
table.insert(self.classes, class)
end
function MessageBox:setParameters()
local args = self.args
local cfg = self.cfg
-- الحصول على بيانات النوع.
self.type = args.type
local typeData = cfg.types[self.type]
self.invalidTypeError = cfg.showInvalidTypeError and self.type and not typeData
typeData = typeData or cfg.types[cfg.default]
self.typeClass = typeData.class
self.typeImage = typeData.image
-- العثور على ما إذا كان الصندوق قد تم استبداله بشكل خاطئ.
self.isSubstituted = cfg.substCheck and args.subst == 'SUBST'
-- العثور على ما إذا كنا نستخدم صندوق رسالة صغير.
self.isSmall = cfg.allowSmall and (
cfg.smallParam and args.small == cfg.smallParam
or not cfg.smallParam and yesno(args.small)
)
-- إضافة الخصائص، والفئات، والأنماط.
self.id = args.id
self.name = args.name
if self.name then
self:addClass('box-' .. string.gsub(self.name, ' ', '_'))
end
if yesno(args.plainlinks) ~= false then
self:addClass('plainlinks')
end
for _, class in ipairs(cfg.classes or {}) do
self:addClass(class)
end
if self.isSmall then
self:addClass(cfg.smallClass or 'mbox-small')
end
self:addClass(self.typeClass)
self:addClass(args.class)
self.style = args.style
self.attrs = args.attrs
-- تعيين نمط النص.
self.textstyle = args.textstyle
-- العثور على ما إذا كنا على صفحة القالب أم لا.
self.useCollapsibleTextFields = cfg.useCollapsibleTextFields
if self.useCollapsibleTextFields or cfg.templateCategory and cfg.templateCategoryRequireName then
if self.name then
local templateName = mw.ustring.match(
self.name,
'^([tT][eE][mM][pP][lL][aA][tT][eE]|قالب)[%s_]*:[%s_]*(.*)$'
) or self.name
templateName = 'قالب:' .. templateName
self.templateTitle = getTitleObject(templateName)
end
self.isTemplatePage = self.templateTitle and mw.title.equals(self.title, self.templateTitle)
end
-- معالجة بيانات حقول النص القابلة للطي. حاليًا، يتم استخدام هذه الحقول فقط في {{ambox}}.
if self.useCollapsibleTextFields then
if self.isSmall and args.smalltext then
self.issue = args.smalltext
else
local sect
if args.sect == '' then
sect = 'هذه ' .. (cfg.sectionDefault or 'الصفحة')
elseif type(args.sect) == 'string' then
sect = 'هذه ' .. args.sect
end
local issue = args.issue
issue = type(issue) == 'string' and issue ~= '' and issue or nil
local text = args.text
text = type(text) == 'string' and text or nil
local issues = {}
table.insert(issues, sect)
table.insert(issues, issue)
table.insert(issues, text)
self.issue = table.concat(issues, ' ')
end
-- الحصول على قيمة talk.
local talk = args.talk
if talk == '' and self.templateTitle and (mw.title.equals(self.templateTitle, self.title) or self.title:isSubpageOf(self.templateTitle)) then
talk = '#'
elseif talk == '' then
talk = nil
end
if talk then
local talkTitle = getTitleObject(talk)
local talkArgIsTalkPage = true
if not talkTitle or not talkTitle.isTalkPage then
talkArgIsTalkPage = false
talkTitle = getTitleObject(
self.title.text,
mw.site.namespaces[self.title.namespace].talk.id
)
end
if talkTitle and talkTitle.exists then
local talkText
if self.isSmall then
local talkLink = talkArgIsTalkPage and talk or (talkTitle.prefixedText .. '#' .. talk)
talkText = string.format('([[%s|نقاش]])', talkLink)
else
talkText = 'قد يكون هنالك نقاشٌ ذو علاقةٍ في'
if talkArgIsTalkPage then
talkText = string.format(
'%s [[%s|%s]] %s.',
talkText,
talk,
talkTitle.prefixedText,
'المتعلق'
)
else
talkText = string.format(
'%s [[%s|%s]] %s.',
talkText,
talkTitle.prefixedText,
'المتعلق',
talk
)
end
end
self.talk = talkText
end
end
end
end
function MessageBox:export()
local cfg = self.cfg
-- إنشاء صف
local row = mw.html.create('tr')
-- إدراج الصورة اليسرى
if self.imageLeft then
local imageLeftCell = row:tag('td'):addClass('mbox-imageleft')
if self.imageCellDiv then
-- إذا كنا نستخدم div، إعادة تعريف imageLeftCell بحيث تكون الصورة داخلها.
imageLeftCell = imageLeftCell:tag('div'):addClass('mbox-image-div')
end
imageLeftCell:wikitext(self.imageLeft or nil)
end
-- إضافة النص
local text = self.issue or self.args.text
if text then
local textCell = row:tag('td'):addClass('mbox-text')
textCell:wikitext(text)
end
-- إضافة الصف إلى الهيكل الرئيسي.
local mainDiv = mw.html.create('div'):addClass('mbox')
mainDiv:node(row)
return tostring(mainDiv)
end
return MessageBox