وحدة:Message box/ملعب
هذه وحدة ميتا التي تنفذ قوالب صندوق الرسائل {{mbox}}، {{ambox}}، {{cmbox}}، {{fmbox}}، {{imbox}}، {{ombox}}، و{{tmbox}}. إنها مخصصة للاستخدام من وحدات Lua، ويجب عدم استخدامها مباشرة من صفحات الويكي. إذا كنت ترغب في استخدام وظائف هذه الوحدة من صفحة ويكي، يرجى استخدام قوالب صندوق الرسائل الفردية بدلاً من ذلك. الاستخداملاستخدام هذه الوحدة من وحدة لوا أخرى، تحتاج أولاً إلى تحميلها. local messageBox = require('Module:Message box')
لإنشاء صندوق رسالة، استخدم وظيفة local box = messageBox.main( boxType, {
param1 = param1,
param2 = param2,
-- مزيد من المعلمات...
})
توجد سبعة أنواع متاحة من الصناديق:
راجع صفحة القالب لكل نوع صندوق لمعرفة المعلمات المتاحة. الاستخدام من #invokeبجانب وظيفة التفاصيل التقنيةتستخدم الوحدة نفس الشيفرة الأساسية لكل من القوالب المذكورة أعلاه؛ تختلف بين كل منها باستخدام البيانات في وحدة:Message box/configuration. فيما يلي خيارات التكوين المختلفة وما تعنيه:
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
|