الگو:Cmbox
 |
 | این الگو تنها توسط مدیران می‌تواند ویرایش شود. زیرا در یک یا چند صفحه حفاظت‌شده آبشاری، تراگنجانش یافته است. |
 | این الگو در تعداد زیادی صفحه صفحه به‌کار رفته است و تغییر دادن آن می‌تواند تأثیرات گسترده‌ای داشته باشد. لطفاً تغییرات را در زیرصفحه‌های /تمرین یا /آزمایشی الگو، یا در زیرصفحهٔ کاربری خودتان بیازمایید. توصیه می‌شود که ابتدا در خصوص تغییرات مورد نظر در صفحهٔ بحث گفتگو کرده و سپس آنها را پیاده‌سازی کنید. |
 | این الگو از لوآ استفاده می‌کند: |
این یک فراالگو (en) است. Cmbox کوته‌نوشت C در Category و m در message و box است.
از این الگو برای ایجاد الگوهای جعبه پیامی، مانند {{انتقال به زیررده}} در صفحات رده‌بندی (en) استفاده کنید. این الگو امکان استفاده از چندین رنگ را می‌دهد. در صورت استفاده نکردن از پارامتر image از تصویر پیش‌فرض استفاده می‌کند. همچنین ویژگی‌های دیگری نیز ارائه می‌کند.
این الگو تقریبا شبیه {{Ambox}} عمل می‌کند و پارامترهایی همانند آن دارد.
استفاده
نمونه استفاده ساده:
{{cmbox | text = متن دلخواه.}}
| متن دلخواه. |
نمونه استفاده پیچیده:
{{cmbox
| type = style
| image = [[پرونده:Emblem-question-yellow.svg|40px]]
| style = width: 400px;
| textstyle = color: red; font-weight: bold; font-style: italic;
| text = متن دلخواه.
}}
 | متن دلخواه. |
گونه‌های جعبه پیامی رده
نمونه‌های زیر از پارامتر type با روش‌های متفاوت و بدون پارامترهای image استفاده می‌کنند. بنابراین در همه آنها از تصویر پیش‌فرض استفاده می‌شود.
 | type=speedy – الگوهای حذف سریع. مانند {{db-c1}}. |
| type=delete – الگوهای حذف. مانند {{cfd}}. |
 | type=content – هشدارها و مشکلات عمده. مانند {{Categorization of people disputed}}. |
 | type=style – هشدارها و مشکلات جزئی. مانند {{Overpopulated category}}. |
| type=notice – اطلاعیه‌ها و پیام‌ها از هر نوع، دائمی و موقت. |
 | type=move – پیام ها و پیشنهادات انتقال، ادغام و تقسیم. مانند {{Category redirect}}. |
 | type=protection – الگوهای حفاظت مانند {{pp}} هنگامی که در یک صفحه رده‌بندی نشان داده شده است. |
تصاویر دیگر
تصاویر پیش فرض نشان داده شده در بالا بیشتر برای راحتی هستند. در بسیاری از موارد، استفاده از تصاویر خاص‌تر مناسبتر است. این نمونه‌ها از پارامتر image برای تعیین تصویری غیر از تصاویر پیش‌فرض استفاده می‌کنند.
 | type = style image = [[پرونده:Sub-arrows.svg|40px]] این تصویر برای {{Overpopulated category}} و {{Category diffuse}} استفاده می‌شود. |
 | type = move image = [[پرونده:Redirect arrow.svg|class=skin-invert-image|52px]] این تصویر برای {{Category redirect}} استفاده می‌شود. |
ویژه
ترکیب برخی پارامترهای دیگر:
| بدون گونه و تصویر (پیش‌فرض) |
| بدون گونه و image=none – بدون استفاده از تصویر، پارامتر text کل عرض جعبه را در بر می‌گیرد. |
 | image = [[پرونده:Gnome globe current event.svg|42px]] imageright = [[پرونده:Nuvola apps bookcase.svg|40px]] |  |
| این رده، جستارها درباره پروازهای فضایی کنونی و اخیر را فهرست می‌کند. این رده توسط الگو {{Current spaceflight}} پر می‌شود. |  |
پارامترها
فهرست همه پارامترها:
{{cmbox
| name = نام الگو
| type = speedy / delete / content / style / notice / move / protection
| image = none / [[پرونده:Some image.svg|40px]]
| imageright = [[پرونده:Some image.svg|40px]]
| class = یک کلاس [[سی‌اس‌اس]] دلخواه برای اعمال به جعبه
| style = مقادیر سی‌اس‌اس
| textstyle = مقادیر سی‌اس‌اس
| plainlinks = no
| text = متن مورد نظر برای جعبه.
}}
name
- (پارامتر اختیاری) نام الگو. این پارامتر یک کلاس سی‌اس‌اس را با نام
box-nameبه المان HTML می‌افزاید.
type
- اگر پارامتر type استفاده نشود، نوع الگو با پیش‌فرض notice (هشدار) آن نمایش داده می‌شود که به معنی پس‌زمینه آبی است.
image
- اگر استفاده نشود = اگر استفاده نشود پارامتر image الگو از تصویر پیش‌فرض استفاده می‌کند که نوع تصویر پیش‌فرض به پارامتر type بستگی دارد.
- اگر استفاده بشود = اگر استفاده بشود باید تصویری مطابق با ویکی‌نماد معمول باشد. بسته به نسبت ارتفاع به عرض تصویر، عرض 40px تا 50px مناسب است. (اگرچه جعبه پیام می‌تواند هر اندازه‌ای را بپذیرد).
- برای نمونه:
image = [[file:Sub-arrows.svg|40px]]
- برای نمونه:
- none = یعنی هیچ تصویری استفاده نمی‌شود.
imageright
- اگر استفاده نشود = اگر استفاده نشود هیچ تصویری در سمت راست جعبه استفاده نمی‌شود.
- اگر استفاده بشود = اگر استفاده بشود باید تصویری مطابق با ویکی‌نماد معمول باشد. بسته به نسبت ارتفاع به عرض تصویر، عرض 40px تا 50px مناسب است. (اگرچه جعبه پیام می‌تواند هر اندازه‌ای را بپذیرد).
- برای نمونه:
imageright = [[file:Nuvola apps bookcase.png|40px]]
- برای نمونه:
- هر چیز = هر چیز دیگری که می‌خواهید در سمت راست جعبه نمایش داده شود.
style
- یک سی‌اس‌اس اختیاری برای استفاده در کل جدول جعبه پیام، بدون استفاده از نماد گفتاورد
" ".- برای نمونه:
style = margin-bottom: 0.5em;
- برای نمونه:
textstyle
- یک سی‌اس‌اس اختیاری برای استفاده در سلول متن.
- برای نمونه:
textstyle = text-align: center;
- برای نمونه:
plainlinks
- در ویکی‌پدیا معمولا در کنار پیوند به بیرون، نماد یک پیکان دیده می‌شود (مانند Example.com). اما در جعبه‌های پیامی به صورت پیش‌فرض، این نماد پیکان نمایش داده نمی‌شود مانند: Example.com. برای نمایش سبک معمولی پیوند به بیرون با نماد پیکان از
|plainlinks=noاستفاده کنید.
text
- متن پیام.
جزئیات فنی
اگر باید از پارامترهای ویژه در پارامتر text استفاده کنید باید اینگونه باشد:
{{cmbox
| text = <div>
علامت مساوی = و ابروی آغاز و پایان به خوبی کار می‌کنند.
این یک خط عمودی {{!}} و دو ابروی پایانی <nowiki>}}</nowiki> است.
اینجا یک خط عمودی و دو ابروی پایانی در کنار هم <nowiki>|}}</nowiki> هستند.
</div>
}}
| علامت مساوی = و ابروی آغاز و پایان به خوبی کار می‌کنند. این یک خط عمودی | و دو ابروی پایانی }} است. اینجا یک خط عمودی و دو ابروی پایانی در کنار هم |}} هستند. |
این الگو برای بیشتر ظاهر خود از کلاس‌های سی‌اس‌اس cmbox در MediaWiki:Common.css استفاده می‌کند. بنابراین ظاهر آن کاملا انعطاف‌پذیر است.
به صورت داخلی این فراالگو از نشانه‌گذاری HTML بجای نشانه‌گذاری ویکی برای کد جدول استفاده می‌کند. این یک روش معمول برای ساخت فراالگوها است. زیرا نشانه‌گذاری ویکی چندین اشکال دارد. برای نمونه، استفاده از توابع تجزیه‌کننده و کاراکترهای ویژه در پارامترها را دشوارتر می‌کند.
تصاویر پیش‌فرض برای این فراالگو بجای قالب SVG دارای قالب PNG هستند. زیرا مرورگرهای وب قدیمی‌تر با پس‌زمینه شفافی که مدیاویکی برای تصاویر SVG ارائه می‌کند، مشکل دارند. تصاویر با قالب PNG در اینجا دارای رنگ پس‌زمینه شفاف بهینه‌سازی شده‌اند، بنابراین در همه مرورگرها خوب به نظر می‌رسند. توجه داشته باشید که آیکون‌های SVG تنها در مرورگرهای قدیمی تا حدودی بد به نظر می‌رسند. بنابراین چنین بهینه‌سازی دستی فقط برای آیکون‌های بسیار پرکاربرد ارزش دردسر دارد.
برای جزئیات بیشتر به صفحه بحث الگو مراجعه کنید. از آنجایی که این الگو تقریباً دقیقاً مانند دیگر جعبه‌های پیامی کار می‌کند، صفحات بحث و صفحات مرتبط با آنها نیز ممکن است حاوی جزئیات بیشتری باشند (به بخش زیر نیز مراجعه کنید).
الگوهای مرتبط
There are several meta-templates in the mbox family:
- {{ambox}} – For article message boxes.
- {{cmbox}} – For category message boxes.
- {{imbox}} – For file (image) page message boxes.
- {{mbox}} – Has namespace detection, for message boxes that are used on several types of pages and thus need to change style depending on what page they are used on.
- {{ombox}} – For other pages message boxes.
- {{tmbox}} – For talk page message boxes.
Closely related meta-templates: