• آموزش ساخت ماژول برای مد ایکس "قسمت اول"1#

  • beginner Reply #1, 5 years, 6 months ago

    Reply
    ساختن ماژول براي مدايکس زياد سخت نيست و شما به راحتي ميتوانید که یک ماژول براي اين سيستم بنويسد
    در اين آموزش سعي مي کنم که با يه مثال اول به شما ياد بدم که چطوري یک ماژول ساخت می شود و براي مديريت يک جدول بانک اطلاعاتي يه ماژول مي سازيم.

    شروع:
    براي شروع اول از همه وارد حساب مديريت شوید
    را انتخاب کنينmodules بعد سربرگ
    را انتخاب کنبدnew هmodules بعد گزينه
    حالا در اين قسمت اسم و توضيحات را براي ماژول انتخاب کنید
    حالا یک نگاه به فيلد آخر بندازید اينجا بايد کد هاي ماژول را بنويسيم
    به عکس زير نگاه کنيد


    حالا بايد ماژول را اجرا کنید براي اين کار روي علامت مکعب آبي کليک کنید

    خوب دوستان بعد از اجراي برنامه شما مشابه تصویر زير را مشاهده مي کنين



    اگر تا الان با من پيش اومده باشين موفق شده اید که اولین ماژول را براي مد ايکس بسازين
    حالا بايد بدانید که اصولأ مديريت مد ايکس چطور کار مي کند براي اينکه به عنوان مثال ماژولي که ساخته اید به خودش لينک بدهد بايد اي دي که مد ايکس به آن ماژول
    داده را بلد باشيد
    براي ديدن اين شماره موس را روی اسم ماژول قرار دهید و در قسمت پايين مرورگر اين شماره نمايان ميشود
    مثل تصویر زیر






    حالا باید ماژول را برای ویرایش باز کنید و به قسمت پیکر بندی ماژول رفته و ای دی به دست آمده رو انجا وارد کنید
    وارد میکنیدmodule configration value ایدی بدست آمده را در قسمت
    دقت کنین که ما اینجا قصد داریم که یه متغییر بسازیم و مقدار آن رو مساوی ماژول قرار بدیم
    استفاده کنینmodule configration valueپس باید از دستور زیر را در
    &modID=modID;int;4 دقت کنید که شماره شما شاید با شماره ای که من وارد کردم فرق داشته باشه
    به تصویر زیر نگاه کنید



    حالا شاید بپرسین که تمام کاری که ما انجام دادیم کلأ چه کاری انجام میده
    با این کار ما اول یک ماژول ساختیم بعد یک متغیر ساختیم و ارزش آن را لینک به ماژول قرار دادیم
    حالا هر وقت توی کد نویسی و و ساخت ماژول به این ماژول نیاز داشته باشیم از این متغییر استفاده میکنیم

    حالا باید کمی به ماژول رنگ و آب بدیم
    توجه کنید که مدیریت در مد ایکس از فریم ها استفاده میکند تا خروجی را به شما نشان دهد پس
    ماژولها باید بصورت کد های اچ تی ام ال باشن ا
    این قابلیت به شما کمک می کند تا هر شکلی دلخواهی به ماژول بدهید

    دو فایل وجود داره که مدیریت مد ایکس برای تمامی فریم ها از آن استفاده می کند
    manager/includes/header.inc.php
    manager/includes/footer.inc.php
    در این حالت ما سعی داریم که ماژول ما از قاب و شکل ماژول مدیریت استفاده کند پس فایل زیر را در نظد بگیرید
    manager/actions/static/modules.static.action.php
    و قسمت های که نیاز داری تا ماژول ما شبیه بخش مدیریت شود را از این فایل به امانت می گیریم
    تا زمانی که ماژول ما فقط یک ماژول است و هنوز تبدیل به بخشی از مدیریت سایت نشده
    ما نیازی به تعیین قالب و بقیه پیش فرض موجود در بخش مدیریت برای آن نداریم
    این کار را انجام دهیم CSS اما اگر بخواهیم آنها را نیز در ماژول خو لحاظ کنیم باید به وسیله لینک دادن به فایل
    برای مثال برای استفاده کردن از قالب مدیریت باید لینکی به کد زیر بدهیم
    $modx->config['manager_theme']

    بطور کلی لینکی که ما در ماژول خود می نویسیم به صورت زیر است
     <link rel="stylesheet" type="text/css" href="media/style/<?php echo $modx->config['manager_theme']; ?>/style.css" />

    همین کار را برای لینک دادن به تمام ایکون ها نیز تکرار کنید

    نوشتن کدها من تمامی کدهای ماژول را در فایلی جداگانه قرار دادم با اینکار به راحتی با نوشتن کد های پی اچ پی و اچ تی ام ال
    به نتیجه دلخواه خود میرسم در صمن توجه کنید که نوشتن کدها در فایل جداگانه
    با عث منظم شدن و سهولت در ویرایش ماژول می شود
    قرار دهیدModule Code: بعد از اینکه ماژول را نوشتید لازم است تا لینک به فایل ماژول را در قسمت
    include $modpad."/ÙØ§Ù ÙØ§ÚÙÙ.php";

    قرار دهید assets/modules/"این فایل را باید در پوشه " پوشه ماژول
    تمام فایلهای جاوا اسکریپت مورد نیاز برای توابع آژاکس نیز در این بخش قرار میگیرند
    ضمنمأ تمام پاسخ های سرور نیز در همین پوشه قابل دریافت است

    دید که ساختن ماژول برای مد ایکس خیلی راحته
    !بزودی قسمت های بعدی را نیز آماده میکنم


  • aghahamidgol Reply #2, 5 years, 6 months ago

    Reply
    خیلی عالی بود ...
    این مقالات را سری سری ادامه بده یک ای بوک می کنیم برای دانلود می زاریم.


  • beginner Reply #3, 5 years, 6 months ago

    Reply
    سعی میکنم که هرچه زودتر قسمت های بعدی را هم بنویسم
    هم بد فکری نیستebook فکر







  • motsmart Reply #4, 5 years, 6 months ago

    Reply
    مسلم جان دستت درد نکنه
    ممنون از اینکه وقت گذاشتی
    هنوز تست نکردم اما چیزی که خوندم به نظرم کامل اومد
    هنوز درگیر ماژولها نشدم
    آموزشهای اینطوری رو حتما ادامه بده و بیشتر کن

    موفق باشی


  • beginner Reply #5, 5 years, 6 months ago

    Reply
    سلام به همه
    ممنون که از دگرمی هاتون
    سعی می کنم به ساده ترین روش قسمت های بعدی رو هم به زودی بنویسم


  • ehsun7b Reply #6, 4 years, 9 months ago

    Reply
    سلام
    ممنون از اینکه زحمت کشیدی و تجربیاتت رو در اختیار بقیه میزاری
    اما به نظرم بخش تغییر ظاهر ماژول به صورت ظاهر مدیریت رو خیلی با عجله گفتی و جزئیات رو توضیح ندادی
    کلا مشکلی که همه ما موقع آموزش دادن داریم رو شما هم تو این آموزش داشتی و اون اینه که تصور کردی همه جزئیات کوچیکی که شما می دونی رو بقیه هم می دونن و همین باعث شده آموزش ناقص باشه و خیلی ها ازش استفاده ای نبرن

    ممنون می شم اگه بازم آموزش بزاری


  • beginner Reply #7, 4 years, 9 months ago

    Reply
    شاید حق با شما باشه
    در هر صورت اگه جایی رو متوجه نشدین بگین تا بیشتر توضیح بدم


    مسلم


  • motsmart Reply #8, 4 years, 9 months ago

    Reply
    سعي داريم از اين به بعد مطالب آموزشي در وايكي(دانشنامه) منتشر بشه تا اگر نقص يا كوتاهي در آنها بود سايرين هم بتونن در آن تغيير مطلوب رو اعمال كنند


  • motsmart Reply #9, 4 years, 4 months ago

    Reply
    [rtl]
    به دانشنامه (وایکی) اضافه شد: http://wiki.modxcms.com/index.php/Fa:Modulemaking1