P R O
همکار باز نشسته
- تاریخ عضویت
- 11 می 2013
- نوشته‌ها
- 4,535
- لایک‌ها
- 4,036
آموزش ارسال و ثبت افزونه در سایت مخزن وردپرس
Add Your Plugin to Wordpress.org
Add Your Plugin to Wordpress.org
در این مقاله، می خواهیم مراحل ارسال یک افزونه ی نوشته شده برای وردپرس را ، بیان و بررسی کنیم .
شما برای ارسال افزونه، نیاز به سه مورد دارید :
1- یک افزونه ی وردپرسی کامل به همراه فایل readme.txt
2- ثبت نام در wordpress.org و ارسال به وردپرس
3- ارسال افزونه به همراه SVN (می توانید برای سهولت از نرم افزار SVN استفاده کنید)
خب مراحل رو اینطوری شروع می کنیم :
مرحله 1) یک افزونه ی وردپرسی کامل به همراه فایل readme.txt
تمامی افزونه ها ، برای اینکه مورد تایید سایت وردپرس قرار گیرند ، نیازمند یک فایل مهم هستند . فایل readme.txt باید در شاخه اصلی پلاگین شما موجود و اصولی ساخته شده باشد.
نوشتن یک readme.txt برای افزونه ها ، اصول خاص خود را دارد.
جهت سهولت بیشتر برای نوشتن این فایل می توانید از ابزار موجود در این سایتکمک بگیرید.
این فایل شامل ورژن افزونه ، نویسنده ، نام افزونه ، توضیحات آن و … می شود که وجود آن برای تمامی افزونه های وردپرسی مخزن الزامی است.
پس از اینکه این فایل را ایجاد کردید، آن را در شاخه اصلی افزونه وردپرسی تان کپی کنید.
مرحله 2) ثبت نام در wordpress.org و ارسال به وردپرس
این کار آموزش خاصی نیاز ندارد! کافیست به سایت WordPress.org مراجعه کنید و ثبت نامکنید.
توجه داشته باشید که نام username شما در این سایت ، باید در فایل readme.txt افزونه قرار گیرد تا افزونه به اکانت وردپرسی شما متصل باشد.
پس از ثبت نام در وردپرس، به این صفحه وارد شوید :
http://wordpress.org...nd/plugins/add/
وارد صفحه افزونه در رایانه خود شوید، کل فایل های آن را به یک فایل zip فشرده کنید.
فایل زیپ را در یک سایت آپلود کنید. می توانید در سایت خودتان آپلود کنید و لینک مستقیم دانلود آن را به وردپرس ارسال کنید.
لینک فایل آپلود شده را در آدرس داده شده در سایت وردپرس وارد کنید.
نام افزونه و توضیحات افزونه را نیز به ترتیب در باکس های بالا و وسط صفحه وارد کنید.
این توضیحات همان توضیحات و نام افزونه شما که در فایل Readme.txt تعیین کرده اید باید باشند .
فرم را تایید کنید و منتظر تایید وردپرس بمانید. وردپرس پس از تایید اولیه پلاگین به شما ایمیل خواهد زد.
معمولاً تایید اولیه زیر 24 ساعت طول می کشد. پس از تایید اولیه افزونه توسط وردپرس، شما باید فایل های آن را توسط SVN به وردپرس ارسال کنید.
در این مرحله پلاگین شما منتشر نشده است و شما باید آنرا منتشر کنید .
مرحله 3) ارسال افزونه به مخزن با SVN
شاید طولانی ترین بخش کار همین باشد ، البته پس از یکی دو بار کار با SVN برای شما بسیار ساده و سریع خواهد شد.
اول باید یک توضیح مختصر درباره ی SVN بدم .
SVN مخفف عبارت “Subversion Version Control” به معنای “نگارش زیر نگارش قابل کنترل” است.
وقتی شما می خواهید افزونه ای را در وردپرس به اشتراک بگذارید، خود وردپرس فضایی را برای فایل های پلاگین شما اختصاص می دهد. این فضا قابل مشاهده برای عموم کاربران است و کنترل آن تنها به دست شماست. SVN این امکان را به کاربران و شما می دهد تا بتوانید نسخه های مختلف منتشر شده از افزونه تان را مقایسه و بررسی کنید .
در واقع SVN تمامی تغییرات انجام شده در تمامی نسخه ها را ذخیره می کند . یعنی اگر شما بخواهید بصورت گروهی هم روی یک پروژه که با SVN کنترل می شود کار کنید و در آن تغییرات مختلف را ایجاد کنید ، نگرانی بابت از دست رفتن اطلاعات ورژن های قبلی نخواهید داشت.
نرم افزار SVN این امکان را به شما می دهد تا این کار را به راحتی و با چند کلیک بسیار ساده انجام دهید.
برای هر افزونه، وردپرس یک آدرس SVN اختصاص داده است.
کلیه تبادلات اطلاعات بین شما و وردپرس برای ارسال نهایی افزونه باید با همین آدرس باشد.
مثلاً برای پلاگین با نام “test” یک آدرس به این صورت اختصاص داده می شود : http://plugins.svn.wordpress.org/test
البته این آدرس ، پس از تایید اولیه ی افزونه ی شما توسط وردپرس، به شما ایمیل می شود .
مراحل ارسال پلاگین با SVN :
1- ابتدا نرم افزار TortoiseSVN را از سایت آن به این آدرس دانلود کنید :
http://tortoisesvn.net/downloads.html
2- پس از نصب کامل نرم افزار ، یک فولدر در یک مکان دلخواه از رایانه خود ایجاد کنید و نام آنرا به دلخواه تغییر دهید. می توانید نام آن را هم نام افزونه بگذارید.
3- روی این فولدر ایجاد شده، راست کلیک کنید و گزینه ی SVN checkout را اتتخاب کنید تا پنجره ی نرم افزار SVN ظاهر گردد .
4- در این پنجره ، آدرس SVN ارسال شده توسط وردپرس را در باکس اول وارد کنید. صفحه را تایید کنید و منتظر باشید تا فایل های اولیه ی موجود در شاخه کپی شوند .
5- پس از مشاهده پیام Complete پنجره را OK کنید.
6- وارد پوشه ساخته شده شوید . در این پوشه چند پوشه اصلی قرار دارند که در ادامه مختصراً معرفی خواهند شد.
7- برای آنکه در صفحه پلاگین وردپرسی شما ، یک کاور قرار داده شود، می توانید یک فایل png در سایز 722 در 750 پیکسل ایجاد کنید و کاور مورد نظر را در آن سایز طراحی کنید و با نام banner-772×250.png در پوشه ی assets ذخیره کنید.
البته وجود این تصویر ، الزامی نیست، و اگر این تصویر را ایجاد نکنید، وردپرس بصورت اتوماتیک هیچ عکسی را در صفحه ی پلاگین شما قرار نخواهد داد.
8- در پوشه ی tags شما باید نسخه های مختلف پلاگین را مشخص کنید. به این صورت که هر ورژنی از افزونه را در یک فولدر جداگانه قرار دهید.
مثلاً اگر شما برای اولین بار است که پلاگین را می خواهید منتشر کنید، باید در فولدر Tags ، یک فولدر با نام 1.0 ایجاد کنید. در این فولدر باید تمامی فایل های افزونه را قرار دهید.
9- همچنین کلیه ی فایل های فعلی پلاگین تون رو باید در فولدر Truck هم کپی کنید . این فایل ها باید به همراه فایل readme.txt باشند .
10- حال زمان ارسال نهایی پلاگین به وردپرس توسط SVN است .
روی فولدر ایجاد شده ، راست کلیک کنید و گزینه ی SVN Commit را انتخاب کنید . در پنجره باز شده ،
در قسمت Message باید یک پیام بنویسید. این پیام به دلخواه شماست. در این بخش باید چیزی که آپدیت یا ارسال می کنید را مختصراً توضیح دهید.
فرض کنید ما برای اولین بار می خواهیم پلاگین را ارسال کنیم. باید در این بخش بنویسید : First release of plugin (یا هر متن دلخواهی) این نوشته ها به عنوان لاگ تغییرات پلاگین بصورت SVN ذخیره خواهند شد.
در باکس پایینی ، کلیه موارد را تیک بزنید تا همه شان ایجاد و یا آپدیت شوند .
در نهایت تایید کنید و در پنجره جدید منتظر پیام Complete باشید.
در صورت موفقیت آمیز بودن کار ، کار انتشار افزونه شما به پایان رسیده است و آدرس اصلی پلاگین شما در مخزن هم در دسترس عموم قرار خواهد داشت.
منبع : سایت شخصی خودم
آموزش ارسال و ثبت افزونه در مخزن وردپرس (WordPress.org)
دوستان اگر سوالی داشتن درخدمتیم.
