آخرین موضوعات آموزش های مربوط به برنامه نویسی

آموزش بررسی بروزرسانی برنامه ها، پلاگینها و قالبها

Tue, 18 Apr 2023 07:44:22 +0000

سلام به همه کاربران عزیز،

تو این آموزش میخوام بهتون یاد بدم که چطور میتونین برای برنامه ها، پلاگینها و قالبهایی که میسازین یک لینک بررسی کننده بروزرسانی قرار بدین تا وقتی کاربرا از اون استفاده میکنن بفهمن که نسخه جدیدی ازش منتشر شده یا نه!

هنگام ایجاد برنامه، پلاگین یا قالب خود، می‌توانید یک URL مشخص کنید. IPS Community Suite دوره‌ای با پارامتر "نسخه" که شماره شناسایی نسخه فعلی را مشخص می‌کند، یک درخواست به URL مشخص شده ارسال می‌کند. به عنوان مثال، اگر URL را به شکل زیر مشخص کنید:

http://www.example.com/myapp/check.php

و کاربری از نسخه ای از برنامه شما با شناسه نسخه "10002" استفاده می کند، سپس درخواست به آدرس زیر ارسال می شود:

http://www.example.com/myapp/check.php?version=10002

آبجکت کدگذاری شده با JSON:

این URL باید با یک آبجکت کدگذاری شده با JSON با ویژگی های زیر بازگردد:

version: نسخه ای که شماره نسخه قابل خواندن توسط انسان (به عنوان مثال "2.0.0") آخرین نسخه موجود را مشخص می کند.

longversion: شماره شناسه طولانی نسخه (به عنوان مثال "20000") از آخرین نسخه موجود

released: تاریخ یونیکس برای تاریخ انتشار آن نسخه

updateurl: نشانی اینترنتی را که مدیر می تواند به روز رسانی را دانلود کند، مشخص می کند

به عنوان مثال، شما ممکن است چیزی شبیه به این را برگردانید:

{
    "version": "3.0.0",
    "longversion": 30000,
    "released": 1523841958,
    "updateurl": "http://www.example.com/myapp/download"
}

امیدوارم موفق باشید!

آموزش ساخت صفحات مجزا بدون استفاده از Pages

Wed, 22 Mar 2023 18:31:50 +0000

با سلام و احترام

قوی و پرکاربرد بودن برنامه Pages بر هیچکس پنهان نیست ، کماکان که اینجانب بلکل سایتمو دارم با Pages میچرخونم.

خب بریم سراغ اصل مطلب ، اینکه یک سری از دوستان شاید علاقه به نصب برنامه Pages نداشته باشند و شاید تنها استفاده شون در حد ساخت چندتا صفحه استاتیک باشه.

در این آموزش صرفا با کد زنی php و html خواهید تونست صفحه ی دلخواهتونو بسازید.

در ابتدا وارد هاستتون بشید و در محلی که IPS رو نصب کردین یک فایل با فرمت .php ایجاد کنید مثلا newfile.php

و کد زیر را در آن قرار دهید:

php
require_once('init.php');
\IPS\Dispatcher\External::i();

$html = 'Lorem ipsum ...';

\IPS\Output::i()->sendOutput( \IPS\Theme::i()->getTemplate('global', 'core')->globalTemplate('Supertolle Seite', $html));

خب الآن فایل مربوطه ساخته شده:

در قسمتی که Lorem ipsum ... نوشته شده میتونید محتوات صفحتونو با تبعیت از قوانین html قرار بدین.

و آدرس این فایل همون لینک مربوطه را تشکیل خواهد داد.

فقط در روت انجمن قابل ساخت می باشد.

بعد از طریف فهرست منو میتونید آن را در منو قرار دهید تا مورد مشاهده بقیه قرار گید.

طبیعت حال اینه که شما هر نمونه قالب html را خواهید تونست پیاده سازی کرد برای امتحان یه قالبی را پیدا کردم و کدشو از لینک روبرو کپی کردم و در همان قسمتی که گفتم گذاشتم : https://www.w3schools.com/w3css/tryit.asp?filename=tryw3css_templates_blog&stacked=h

کد قالب:

php
require_once('init.php');
\IPS\Dispatcher\External::i();

$html = '

W3.CSS Template











 
  MY BLOG
  Welcome to the blog of unknown







  
  
    
    
      TITLE HEADING
      Title description, April 7, 2014
    

    
      Mauris neque quam, fermentum ut nisl vitae, convallis maximus nisl. Sed mattis nunc id lorem euismod placerat. Vivamus porttitor magna enim, ac accumsan tortor cursus at. Phasellus sed ultricies mi non congue ullam corper. Praesent tincidunt sed
        tellus ut rutrum. Sed vitae justo condimentum, porta lectus vitae, ultricies congue gravida diam non fringilla.
      
        
          
        
        
          Comments   0
        
      
    
  
  

  
  
  
    
      BLOG ENTRY
      Title description, April 2, 2014
    

    
      Mauris neque quam, fermentum ut nisl vitae, convallis maximus nisl. Sed mattis nunc id lorem euismod placerat. Vivamus porttitor magna enim, ac accumsan tortor cursus at. Phasellus sed ultricies mi non congue ullam corper. Praesent tincidunt sed
        tellus ut rutrum. Sed vitae justo condimentum, porta lectus vitae, ultricies congue gravida diam non fringilla.
      
        
          
        
        
          Comments   2
        
      
    
  





  
  
  
    
      My Name
      Just me, myself and I, exploring the universe of uknownment. I have a heart of love and a interest of lorem ipsum and mauris neque quam blog. I want to share my world with you.
    
  

  
  
  
    
      Popular Posts
    
    
      
        
        Lorem

        Sed mattis nunc
      
      
        
        Ipsum

        Praes tinci sed
       
      
        
        Dorum

        Ultricies congue
         
      
        
        Mingsum

        Lorem ipsum dipsum
        
    
  
   
 
  
  
    
      Tags
    
    
    Travel New York London
      IKEA NORWAY DIY
      Ideas Baby Family
      News Clothing Shopping
      Sports Games
    
    
  
  












  
  
  Powered by w3.css




';

\IPS\Output::i()->sendOutput( \IPS\Theme::i()->getTemplate('global', 'core')->globalTemplate('Supertolle Seite', $html));

و نتیجه نهایی به شکل زیر شد:

نویسنده: @Mohammad Mz

امیدوارم موفق باشید!

آموزش اپلیکیشن نویسی برای IPS

Mon, 09 Jan 2023 16:58:07 +0000

سلام خدمت همه کاربران.

بعد مدتها با یهآمورش خفن اومدم پیشتون.

خیلیا دنبال اینن که نحوه برنامه نویسی برای انجمن ساز رو یاد بگیرن و برنامه های شخصی خودشون رو توسعه بدن حالا تو این آموزش میخوام در مورد این برای توضیحاتی بدم و امیدوارم که بتونه مشکلاتتونو حل بکنه!

فعال سازی حالت Developer Mode:

ابتدا آخرین نسخه توسعه دهنده را از این لینک دانلود کنید و طبق آموزش زیر آنرا اجرا و فعال کنید!

اگر همه مراحل را درست انجام داده باشید بعد از وارد شدن به ادمین باید با صفحه ای مثل زیر رو بهرو شوید:

ایجاد اولین برنامه:

در ادمین به مسیر System => Applications رفته و روی دکمه Create New کلیک کنید

در صفحه باز شده اطلاعات خواسته شده را تکمیل کنید. (Directory برای هر برنامه ساخته شده باید منحصر به فرد باشد در غیر اینصورت برنامه کار نخواهد کرد)

در قسمت update check url باید لینک مسیری که اطلاعت آپدیت در آن قرار میگیرد را باید وارد کنید. (بعدا توضیح خواهم داد)

خب تا اینجای کار شما تونستین یک چهارچوبی از برنامه خودتون رو بسازین!

خب در حال حاضر، برنامه شما هیچ کاری انجام نمی ده و باید یکسری کدها توش قرار بگیره!

در هاست یا لوکال خود فایل های خود پوشه "applications" و در داخل این پوشه برنامه خود را دارید. برای من این پوشه "helloworld" است. پوشه خود را با برنامه از طریق PHPStorm یا VSCode باز کنید. من از VSCode استفاده می کنم.

اکنون به دنبال ساختار دایرکتوری باشید. می‌توانید پوشه‌ها را کاوش کنید، اما به یاد داشته باشید، پوشه «داده» به‌طور خودکار تولید می‌شود، بنابراین نمی‌توانید فایل‌ها را در اینجا تغییر دهید (به استثنای furl.json).

ایجاد صفحه:

بسیار خوب، بیایید صفحه اول در برنامه شما ایجاد کنیم.

به مسیر System => Side Features => Applications بروید و برنامه خودتون رو پیدا کنید و روی گزینه Developer center کلیک کنید

ایجاد ماژول:

به تب Modules — Front بروید

ماژول ها کلاس های اصلی ما هستند که می توان گفت به عنوان پوشه ها خدمت می کنند. ماژول ها و کنترلرهای مورد استفاده در قسمت جلویی برنامه شما را تعریف می کند. فایل‌ها و پوشه‌ها در پوشه‌ها/ماژول‌های شما ایجاد می‌شوند.

حالا بیایید ماژول جدید ایجاد کنیم، روی دکمه "Add Module" کلیک کنید و "Module Key" را ارائه کنید. من "helloworld" را تایپ می کنم.

ایجاد کنترولر:

در شیب بعدی، کنترل‌کننده‌ای را برای صفحه اول خود ایجاد می‌کنیم. دکمه "Plus" را پیدا کنید، روی آن کلیک کنید و نام فایل را وارد کنید. من "pagetest" را تایپ می کنم.

اکنون فایل های موجود در برنامه های خود را بررسی کنید. ما یک ماژول به نام «helloworld» و یک کنترلر به نام «pagetest.php» ایجاد کردیم.

فایل “pagetest.php” را باز کنید. IPS به طور خودکار ساختار اصلی فایل را برای ما ایجاد کرد. آن را تغییر ندهید، به جز متدهایی که در داخل کلاس هستند.

روش های داخلی:

Execute: کد زمانی که توابع دیگر را رندر می کند فقط یک بار اجرا می شود

Manage: عملکرد اصلی برای کنترلر شما

خب اینم از اولین صفحه شما!

اکنون می توانید با کوئری appropriate به صفحه خود بروید:

http://localhost/index.php?app=helloworld&module=helloworld&controller=pagetest

ایجاد قالب HTML:

صفحه ما خالی است ما باید صفحه HTML ایجاد کنیم تا چیزی در اینجا نمایش داده شود. به فایل های برنامه خود بروید و پوشه 'dev/html' را باز کنید.

ما در اینجا 3 پوشه اصلی داریم:

front: نمایش در فرانت

admin: نمایش در ادمین

global: نمایش در فرانت و ادمین

برای برنامه ما پوشه جدید "front" ایجاد کنید.

در داخل پوشه "front" یک پوشه جدید (برای گروه) به عنوان مثال "pagetest" و در داخل پوشه "index.phtml" ایجاد کنید. نام فایل و پوشه اختیاری است.

در داخل “index.phtml” در فایل بالایی باید هدر بنویسید. افزودن به فایل (در بالا):

 parameters="" />

در زیر می توانید HTML خود را بنویسید. مثال:

 parameters="" />
Wow! My first page in IPS! Hi :)

در مرحله بعد این کد HTML را در کنترلر خود رندر می کنیم. کنترلر داخلی (برای من pagetest.php) روش مدیریت را تغییر دهید.

\IPS\Output::i()->output = \IPS\Theme::i()->getTemplate(group, appName, module)->filename();

module: پوشه front/admin/global

group: نام پوشه در پوشه module

appName: نام برنامه شما (نام برنامه را می توانید در هر فایل php بر اساس فضای نام بیابید، به عنوان مثال "Namspace IPS\helloworld". "helloworld" این نام برنامه من است)

filename: فایل phtml شما

کد کامل اینجا برای من:

protected function manage()
{
  \IPS\Output::i()->output = \IPS\Theme::i()->getTemplate('pagetest', 'helloworld', 'front')->index();
}

اکنون متن داخل صفحه داریم!

رشته های زبانی:

IPS دارای ماژول زبان برای رشته ها است. بیایید چند رشته اضافه کنیم. به برنامه فایل های خود بروید و فایل را در "dev/lang.php" باز کنید. سپس تعدادی رشته اضافه کنید.

php

$lang = [
 '__app_helloworld' => "Hello World",
 'module__helloworld_helloworld' => "My helloworld Module",
 'hello_world_test_page' => "Wow! My first page in IPS! Hi :) for English"
];

"module__helloworld_helloworld" برای ماژول شما در breadcrumb است.

اکنون به فایل «index.phtml» خود بازگردید. جایگزینی محتوا و ذخیره فایل:

 parameters=”” />
{lang="hello_world_test_page"}

اکنون برنامه شما از کلید "hello_world_test_page" برای نمایش رشته "Wow! اولین صفحه من در IPS! سلام :) برای انگلیسی”.

Breadcrumbs:

شما می توانید پودر سوخاری خود را برای صفحه ایجاد کنید. به کنترلر خود بروید و روش مدیریت را تغییر دهید.

\IPS\Output::i()->breadcrumb[] = [null, \IPS\Member::loggedIn()->language()->addToStack('hello_world_test_page')];

این خط آرایه با 2 پارامتر را می پذیرد:

URL: تهی فعلی اگر صفحه فعلی باشد

String: برای نمایش متن

این IPS داخلی ماژول زبان روش است. «hello_world_test_page» کلید زبان شماست.

\IPS\Member::loggedIn()->language()->addToStack('hello_world_test_page');php

خروجی:

عنوان صفحه:

ما صفحه عنوان فعلی نداریم. برگه مرورگر را برای صفحه فعلی در IPS خود بررسی کنید.

اگر بخواهیم متنی را در اینجا اضافه کنیم، می توانیم این کار را با تغییر روش مدیریت در کنترلر شما انجام دهیم.

\IPS\Output::i()->title = \IPS\Member::loggedIn()->language()->addToStack('hello_world_test_page');

خروجی:

خروجی گرفتن از برنامه:

اکنون می توانید برای جامعه تولید خود اپلیکیشن بسازید. به AdminCP => System => Side Features => Applications بروید. برنامه خود را پیدا کنید و روی دکمه "دانلود" کلیک کنید.

نسخه جدید را انتخاب کنید و روی "ذخیره" کلیک کنید.

انجام شده! اکنون نسخه «.tar» برنامه خود را دارید.

تبریک می گویم! شما اولین برنامه را در موتور IPS ایجاد کردید. اگر گم شده اید، به کد منبع در GitHub من نگاه کنید.

آموزش کار با متغیر Member در پلاگین نویسی و برنامه نویسی

Mon, 04 Jul 2022 07:57:04 +0000

سلام خدمت همه توسعه دهنده های عزیز،

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

برخی از ویژگی های خاص که از طریق دریافت کننده ها در دسترس هستند:

$member->group:

این یک گیرنده ویژه است (این یک ویژگی است، نه یک روش) که داده های گروه اعضا را برمی گرداند. این روش به طور خودکار دسترسی های گروه اصلی و یک یا چند گروه ثانویه را ادغام می کند و بهترین دسترسی های ممکن را بر اساس عضویت در گروه به کاربر می دهد.

$member->groupName:

این نام گروه کاربری را که بر اساس مدیریت فرمت شده است را برمی گرداند.

$member->groups:

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

$member->real_name:

در صورتی که کاربر واقعاً مهمان باشد، به جای بازگرداندن رشته زبان برای «مهمان»، نام کاربر یا یک رشته خالی را برای مهمان برمی گرداند.

$member->birthday:

با در نظر گرفتن این واقعیت که ارائه سال تولد اختیاری است، تاریخ تولد محلی عضو را برمی گرداند.

$member->photo:

این ویژگی عکس کاربر را به عنوان یک شی \IPS\Url برمی‌گرداند.

$member->rank:

این روش آرایه‌ای را که عنوان و تصویر را برای «درجه» فعلی کاربر بر اساس پیکربندی رتبه‌های ACP است برمی‌گرداند، با در نظر گرفتن این واقعیت که هم یک تصویر آپلود شده و هم تصاویر «pip» پشتیبانی می‌شوند، برمی‌گرداند.

چند روش در کلاس \IPS\Member وجود دارد که باید با آنها آشنا باشید:

$member->location():

اگر کاربر آنلاین است، مکان فعلی آنها را در سایت برمیگرداند.

$member->isAdmin():

آیا کاربر در گروه مدیریت کل است یا خیر،

$member->isOnline():

آیا کاربر در حال حاضر آنلاین است یا خیر.

$member->isBanned():

آیا کاربر بن شده است یا خیر.

$member->profileFields():

فیلدهای نمایه سفارشی را برای کاربر به عنوان آرایه ای از اشیاء فیلد نمایه برمیگرداند.

$member->contentProfileFields():

این شبیه به profileFields() است اما در عوض فقط فیلدهای نمایه طراحی شده برای نمایش در کنار محتوای کاربر را برمی گرداند (به عنوان مثال در نوار کناری سمت چپ کنار یک پست)

$member->ipAddresses():

آدرس های IP استفاده شده توسط کاربر را برمیگرداند.

$member->language():

نمونه‌ای از \IPS\Lang را برای کاربر بر اساس ترجیحاتشان برمی‌گرداند، یا بر اساس تشخیص خودکار/تنظیم زبان پیش‌فرض. اگر کاربر زبانی را انتخاب نکرده باشد. این برای بازیابی رشته های زبان استفاده می شود، به عنوان مثال. \IPS\Member::loggedIn()->language()->addToStack('language_string' );

$member->reputation():

این روش امتیاز کاربر را به عنوان یک رشته زبان برمی گرداند.

$member->reputationImage():

این روش تصویر امتیاز کاربر را برمی گرداند. (از نسخه های 4.5 به بعد این متغیر برداشته شده است)

$member->delete( $setAuthorToGuest=TRUE ):

برای حذف یک کاربر از این روش بهره بگیرید. تنها پارامتر پذیرفته شده نشان می‌دهد که آیا محتوایی که توسط کاربر ایجاد شده است در صورت صحیح بودن به حساب مهمان تنظیم شود یا نه، یا اگر آن محتوا نادرست است حذف شود. توجه داشته باشید که اگر از کنترل کننده های ورود خارجی استفاده می کنید که از حذف یک کاربر پشتیبانی می کند، کاربر در آن پایگاه داده های خارجی نیز حذف می شود.

$member->flagAsSpammer():

این روش، حساب کاربری را به‌ عنوان هرزنامه علامت‌گذاری می‌کند، محتوای آن‌ها را بر اساس پیکربندی مدیریت حذف یا پنهان می‌کند، و هرزنامه‌کننده را به سرویس هرزنامه IPS گزارش می‌دهد (اگر برای این کار پیکربندی شده باشد).

$member->unflagAsSpammer():

این روش حساب کاربر را به‌عنوان هرزنامه حذف می‌کند و در صورت پیکربندی، تغییر وضعیت را به سرویس هرزنامه IPS گزارش می‌دهد.

$member->age( $date=NULL ):

سن کاربر را برمیگرداند. اگر یک شی \IPS\DateTime به عنوان تنها پارامتر به متد ارائه شود، سن بر اساس تاریخ ارائه شده محاسبه می شود.

$member->inGroup( $group, $permissionArray=FALSE ):

بررسی میکند که آیا کاربر به یک گروه یا مجموعه ای از گروه ها تعلق دارد یا خیر. $group می‌تواند یک شناسه گروه (عدد صحیح)، یک نمونه از \IPS\Member\Group یا آرایه‌ای از شناسه‌های گروه یا نمونه‌های \IPS\Member\Group باشد. اگر کاربر عضو هر گروهی در آرایه باشد، متد TRUE را برمی گرداند. اگر $permissionArray به عنوان TRUE ارسال شود، کاربر به جای شناسه گروه با آرایه دسترسی کاربران بررسی می شود.

$member->url():

URL را به عنوان نمونه ای از \IPS\Http\Url به نمایه کاربر برمیگرداند.

$member->acpUrl():

URL را به عنوان نمونه ای از \IPS\Http\Url به صفحه کاربر ویرایش در ACP برگردانید.

$member->link( $warningRef=NULL, $groupFormatting=FALSE ):

یک پیوند HTML را به نمایه کاربر برمیگرداند. اگر $warningRef به عنوان یک رشته ارسال شود، این نشان دهنده کلید مرجع برای هشدار به کاربر خواهد بود (اگر به کاربر اخطار داده شود). $groupFormatting نشان می دهد که آیا نام نمایش داده شده با استفاده از گزینه های قالب بندی گروه کاربر که توسط مدیریت تنظیم شده است، فرمت شود یا نه.

$member->markAllAsRead():

کل سایت را به عنوان خوانده شده برای کاربر علامت گذاری میکند.

$member->markersItems( $app, $key ):

نشانگرهای مورد را برای کاربر برای برنامه و کلید مورد نظر واکشی میکند.

$member->markersResetTimes( $app ):

زمان بازنشانی نشانگر مورد را برای کاربر برای برنامه داده شده واکشی میکند.

$member->warnings( $limit, $acknowledged=NULL, $type=NULL ):

اخطارهای کاربر را بازیابی میکند. Limit را می توان به عنوان یک عدد صحیح برای محدود کردن تعداد بازگردانده ارسال کرد. اگر $acknowledged NULL باشد، همه اخطارها برگردانده می‌شوند، یا می‌توان TRUE یا FALSE را ارسال کرد تا هشدارها فقط به هشدارهای تایید شده یا تایید نشده محدود شود. اگر $type به عنوان یک رشته ارسال شود، فقط اخطارهایی از آن نوع می‌گیرد.

$member->encryptedPassword( $password ):

رمز عبور متن ساده را برای کاربر با استفاده از Salt کاربر رمزگذاری کنید (ممکن است بخواهید قبل از فراخوانی برای رمز عبور جدید، Salt را به روز کنید).

$member->generateSalt():

یک Salt جدید برای کاربر ایجاد کنید.

$member->notificationsConfiguration():

پیکربندی اعلان‌های کاربر را برمیگرداند.

$member->following( $app, $area, $id ):

تعیین میکند آیا کاربر یک برنامه، منطقه و ترکیب ID خاص را دنبال می کند (همه مقادیر باید ارسال شوند)

$member->acpRestrictions():

محدودیت های ACP کاربر را برمیگرداند تا مشخص شود که کاربر به کدام مناطق ACP می تواند دسترسی داشته باشد.

$member->modPermissions():

در صورت وجود، دسترسی های مدیریتی کاربر را برمیگرداند.

$member->reportCount():

تعداد موارد محتوای گزارش شده را که کاربر می تواند در مرکز گزارش مشاهده کند، دریافت میکند.

$member->isIgnoring( \IPS\Member $member, $type ):

تعیین میکند که آیا کاربر کاربر دیگری را نادیده می گیرد یا خیر. $type باید ارسال شود و باید یکی از «امضا»، «موضوع» یا «پیام» باشد.

$member->createMenu():

منوی ایجاد کاربر را واکشی کنید. این کش ذخیره می شود (و در صورت نیاز به طور خودکار پاک می شود).

$member->moderateNewContent():

تعیین میکند که آیا محتوای جدید ایجاد شده توسط کاربر باید تعدیل شود یا خیر.

$member->coverPhoto():

در صورت وجود عکس کاور کاربر را برمیگرداند.

$member->hasAcpRestriction( $app, $module=NULL, $key=NULL ):

تعیین کنید که آیا کاربر دارای محدودیت ACP برای یک $app، $module و $key ترکیبی است (فقط $app مورد نیاز است). اگر کاربر دارای محدودیت باشد، به این معنی است که آنها می توانند به منطقه داده شده دسترسی داشته باشند.

$member->modPermission( $key=NULL ):

تعیین میکند که آیا کاربر دارای دسترسی مدیریتی معینی برای حساب خود است (برای تعیین اینکه آیا کاربر دسترسی های مدیریتی در دسترس دارد، NULL را پاس کنید).

$member->canWarn( \IPS\Member $member ):

تعیین کنید که آیا کاربر فعلی می تواند به کاربر دیگری هشدار دهد یا خیر.

$member->checkLoginKey():

بررسی میکند که کاربر دارای یک مجموعه کلید ورود میباشد و منقضی نشده است.

$member->recountNotifications():

اعلان های خوانده نشده کاربر را بازشماری میکند.

$member->recountContent():

بازشماری تاپیکهای کاربر.

$member->recountReputation():

شمارش امتیاز اعضا را بازگو میکند.

$member->canAccessModule( $module ):

$module باید نمونه ای از \IPS\Application\Module باشد و متد نشان می دهد که آیا کاربر می تواند به ماژول دسترسی داشته باشد یا خیر.

$member->merge( \IPS\Member $otherMember ):

کاربر فعلی را با یک حساب کاربر دیگر ادغام میکند (توجه داشته باشید که ادغام محتوا در پس‌زمینه اتفاق می‌افتد و ممکن است بلافاصله اتفاق بیفتد؛ علاوه بر این، حساب کاربری که حذف می‌شود تا زمانی که همه محتوا ادغام نشود، در صف قرار می‌گیرد و حذف نمی‌شود).

$member->checkPostsPerDay():

محدودیت‌های روزانه پست‌ها را بررسی میکند تا ببینید آیا کاربر می‌تواند بازدید کند یا خیر.

$member->checkGroupPromotion():

بررسی میکند که آیا عضو باید به گروه دیگری ارتقا یابد یا خیر، و اگر چنین است این کار را انجام دهد. توجه داشته باشید که save() همچنان باید بعد از آن به صورت دستی فراخوانی شود.

$member->clearCreateMenu():

منوی ایجاد حافظه پنهان برای کاربر را پاک کنید.

آموزش استفاده از constants.php

Sun, 09 Jan 2022 08:52:43 +0000

سلام به همه کاربران عزیز

تو این آموزش میخوام بهتون از کاربردهای فایل constants.php بگم و بهتون یاد بدم که چطوری و تو چه مواقعی میتونین ازش استفاده کنین

اگر توسعه دهنده برنامه ها و پلاگینهای IPS باشین قطعا با این فایل آشنایی دارین و یا اگه تازه کار هستین این آموزش مختص شماست. البته تو مواردی دیگری هم میشه ازش استفاده کرد که در توضیحات بعدی خدمتتون میگم.

Constants.php یک فایل ویژه است که شما به صورت اختیاری در دایرکتوری اصلی انجمن خود ایجاد می کنید که می تواند شامل دستورات ویژه و گزینه های پیکربندی باشد که رفتار عادی انجمن شما را تغییر می دهد.

خب برای شروع ما نیاز به یک انجمن نصب شده داریم و در محلی که انجمن رو نصب کردیم یک فایل به اسم constants.php میسازیم و کدهای زیر رو بسته به نیازمون توش قرار میدیم:

هشدار: تغییر هر یک از این مقادیر بدون آگاهی کامل از کاری که انجام می‌دهید می‌تواند منجر به مشکلات سیستم شود.

ساختار استفاده:

php
\define('مقدار ','ثابت');

دستورات:

ثابت: CP_DIRECTORY

کاربرد: نام دایرکتوری ادمین شمارو از پیشفرض admin به مقدار دلخواه شما تغییر میده

مقدار: newcpdirectory

ثابت: IN_DEV

کاربرد: انجمن شمارو در حالت developer mode قرار میده و در مواقعی که نیاز به توسعه برنامه و پلاگین داشته باشین میتونین از این دستور استفاده کنین

مقدار: TRUE

ثابت: IPS_FOLDER_PERMISSION

کاربرد: دسترسی پیشفرض پوشه هارو به مقدار قابل نوشتن تنظیم میکند

مقدار: 0777

ثابت: FOLDER_PERMISSION_NO_WRITE

کاربرد: دسترسی پیشفرض پوشه هارو به مقدار قابل نوشتن تنظیم میکند

مقدار: 0755

ثابت: IPS_FILE_PERMISSION

کاربرد: دسترسی پیشفرض پوشه هارو به مقدار قابل نوشتن تنظیم میکند

مقدار: 0666

ثابت: FILE_PERMISSION_NO_WRITE

کاربرد: دسترسی پیشفرض پوشه هارو به مقدار قابل نوشتن تنظیم میکند

مقدار: 0644

ثابت: COOKIE_PREFIX

کاربرد: پیشوند برای افزودن به هر کوکی. اگر کوکی هایی به همین نام برای استفاده های دیگر دارین میتونه مفید باشه.

مقدار: 'ips4_'

ثابت: UPGRADE_MANUAL_THRESHOLD

کاربرد: شمارش ردیف در جدول قبل از اینکه درخواست پرس و جو دستی رخ بده.

مقدار: 250000

ثابت: UPGRADE_LARGE_TABLE_SIZE

کاربرد: اندازه جدول قبل از درخواست پرس و جو دستی رخ خواهد بده.

مقدار: 100000000

ثابت: USE_DEVELOPMENT_BUILDS

کاربرد: افزودن مقدار true به این به ارتقا دهنده خودکار اجازه میده تا نسخه های عمومی آلفا و بتا رو انتخاب کنه.

مقدار: TRUE

ثابت: TEMP_DIRECTORY

کاربرد: این بطور پیش‌فرض از تنظیمات دایرکتوری temp سرور شما استفاده می‌کند

مقدار: '/some/full/path/'

ثابت: BYPASS_ACP_IP_CHECK

کاربرد: بررسی IP را از ACP شما حذف می کند

مقدار: TRUE

ثابت: RECOVERY_MODE

کاربرد: برای بازیابی سیستماستفاده میشود.

مقدار: TRUE

ثابت: DISABLE_MFA

کاربرد: احراز هویت دو عاملی در سیستم رو غیرفعال میکنه.

مقدار: TRUE

ثابت: REBUILD_SLOW

کاربرد: تعداد مواردی که باید در هر چرخه برای روتین‌هایی که مدتی طول می‌کشد بازسازی شوند (فقط در صورتی تغییر بدین که 100% مطمئن باشین که سرور یا هاست شما از پس آن بر می آید)

مقدار: 50

ثابت: REBUILD_NORMAL

کاربرد: تعداد مواردی که در هر چرخه برای اکثر روتین‌ها بازسازی می‌شوند (فقط در صورتی تغییر بدین که 100% مطمئن باشین که سرور یا هاست شما از پس آن بر می آید)

مقدار: 250

ثابت: REBUILD_QUICK

کاربرد: تعداد مواردی که باید در هر چرخه برای روتین‌هایی که سریع هستند بازسازی شوند (فقط در صورتی تغییر بدین که 100% مطمئن باشین که سرور یا هاست شما از پس آن بر می آید)

مقدار: 500

این دستورات رایجترین ثابتهایی هستن که میتونن بیشترین استفاده رو داشته باشن.

لیست کامل دستورات ثابت:

DEV_USE_WHOOPS              														     => TRUE
DEV_USE_FURL_CACHE         														      => FALSE
DEV_USE_MENU_CACHE      												            => FALSE
DEBUG_JS                         																  => FALSE
DEV_DEBUG_JS                   															     => TRUE
DEV_DEBUG_CSS            													               => FALSE
DEBUG_TEMPLATES              												           => FALSE
IPS_FOLDER_PERMISSION                                                              => 0777
FOLDER_PERMISSION_NO_WRITE                                                 => 0755
IPS_FILE_PERMISSION                                                                    => 0666
FILE_PERMISSION_NO_WRITE                                                       => 0644
ROOT_PATH                                                                                     => __DIR__
NO_WRITES                                                                                      => FALSE
DEBUG_LOG                                                                                     => FALSE
LOG_FALLBACK_DIR                                                                       => '{root}/uploads/logs'
STORE_METHOD                                                                             => 'FileSystem'
STORE_CONFIG                                                                               => '{"path":"{root}/datastore"}'
CACHE_METHOD                                                                            => 'None'
CACHE_CONFIG                                                                              => '{}'
CACHE_PAGE_TIMEOUT                                                                => 30
TEST_CACHING                                                                              => FALSE
EMAIL_DEBUG_PATH                                                                     => NULL
BULK_MAILS_PER_CYCLE                                                             => 500
JAVA_PATH                                                                                    => ""
ERROR_PAGE                                                                                  => 'error.php'
UPGRADING_PAGE                                                                         => 'upgrading.html'
QUERY_LOG                                                                                     => FALSE
CACHING_LOG                                                                                => FALSE
ENFORCE_ACCESS                                                                         => FALSE
THUMBNAIL_SIZE                                                                          => '500x500'
PHOTO_THUMBNAIL_SIZE                                                           => 240
COOKIE_DOMAIN                                                                           => NULL,
COOKIE_PREFIX                                                                             => 'ips4_'
COOKIE_PATH                                                                                => NULL
COOKIE_BYPASS_SSLONLY                                                          => FALSE
CONNECT_NOSYNC_NAMES                                                        => FALSE
BYPASS_CURL                                                                                => FALSE
FORCE_CURL                                                                                  => FALSE
NEXUS_TEST_GATEWAYS                                                            => FALSE
NEXUS_LKEY_API_DISABLE                                                          => TRUE
NEXUS_LKEY_API_CHECK_IP                                                        => TRUE
NEXUS_LKEY_API_ALLOW_IP_OVERRIDE                                    => FALSE
UPGRADE_MANUAL_THRESHOLD                                               => 250000
HTMLENTITIES'                                                                              =>( version_compare( phpversion(), '5.4.0', '<' ) ) ? ENT_IGNORE : ENT_DISALLOWED
SUITE_UNIQUE_KEY                                                                      => mb_substr( md5( '02bf3' . '$Rev: 3023$'), 10, 10 )
CACHEBUST_KEY                                                                          => mb_substr( md5( '02bf3' . '$Rev: 3023$'), 10, 10 )
SITE_SECRET_KEY                                                                        => NULL
TEXT_ENCRYPTION_KEY                                                             => NULL
CONNECT_MASTER_KEY                                                             => NULL
USE_DEVELOPMENT_BUILDS                                                      => FALSE
DEV_WHOOPS_EDITOR                                                                 => NULL
DEFAULT_REQUEST_TIMEOUT                                                    => 10
LONG_REQUEST_TIMEOUT                                                          => 30
TEMP_DIRECTORY                                                                        => sys_get_temp_dir()
TEST_DELTA_ZIP                                                                          => ''
DELTA_FORCE_FTP                                                                      => FALSE
BYPASS_ACP_IP_CHECK                                                             => FALSE
IPS_FOLDER_PERMISSION                                                          => 0755
FOLDER_PERMISSION_NO_WRITE                                             => 0755
IPS_FILE_PERMISSION                                                               => 0644
FILE_PERMISSION_NO_WRITE                                                  => 0644

برای کسب اطلاعات بیشتر میتونین به این صفحه مراجعه کنین!

امیدوارم موفق باشید!

آموزش نحوه فعالسازی حالت Developer Mode

Sun, 17 Oct 2021 07:55:28 +0000

سلام خدمت همه کاربران،

تو این تاپیک قراره در مورد حالت توسعه دهنده توضیح بدم. شما برای اینکه بخواین یه پلاگین یا برنامه ای رو بسازین و توسعه بدین نیاز هستش که انجمنتون رو با حالت Developer Mode بالا بیارین. اینکار در واقع باعث می شه نرم افزار به جای نسخه های ذخیره شده از پایگاه داده، فایلهای مورد نیاز رو مستقیماً از سیستم فایل بارگیری کنه.

هشدار: حالت توسعه دهنده باعث می شود نرم افزار بسیار کندتر از معمول اجرا شود و ممکن است آسیب پذیری های امنیتی را ایجاد کند. شما از این حالت باید موقعی استفاده کنید که یک برنامه نویس PHP هستید که قصد توسعه برنامه ها و افزونه ها را دارید و این کار را فقط در لوکال انجام دهید که دسترسی به وب ندارد.

فعال کردن حالت Developer Mode:

برای فعالسازی مراحل زیر رو دنبال کنین:

ابتدا از این لینک فایل رو دانلود کنین. دقت کنین که نسحه هماهنگ با انجمن ساز مورد استفائتون رو دانلود کنین.

فایل را در محلی که انجمن رو نصب کردین منتقل کنین و از حالت فشرده خارج کنین تا با فایلهای قبلی ادغام بشن. بعد از اینکار شما یک پوشه dev در روت و پوشه های dev دیگری برای برنامه های نصب شدتون میبینید. (منظور از برنامه ها برنامه های خود سیستم هستند نه برنامه هایی که شما نصب کردین). دقت کنین که اگه شما مثلا در انجمن سازی که استفاده میکنین برنامه گالری و وبلاگ رو نصب نکردین بهتره قبل از ادغام با فایلهای دولوپر مد اونهارو از فایل زیپ شده دولومپر مد حذف کنین. چون وجود ابزارهای توسعه دهنده برای برنامه های حذف نشده ممکن است باعث خطا شود.

اگر در محل نصب (روت) از قبل فایلی با نام constants.php نساخته اید ابتدا یک فایل با همین نام بسازید و کدهای زیر را درون آن قرار داده و ذخیره کنید:

php
define( 'IN_DEV', TRUE );

توجه: در هر آپدیت انجمن شما نیز باید نسخه به روز developer mode رو دانلود و استفاده کنین!

امیدوارم موفق باشید!

آموزش استفاده از کدهای شرطی if در IPS

Sat, 05 Jun 2021 10:21:29 +0000

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

بعد مدتها با این آموزش اومدم خدمتتون. تو این آموزش بهتون یاد میدم که چطور میتونین از کدهای شرطی if خود IPS در جاهای مختلف انجمن استفاده کنین.

اگه با زبان برنامه نویسی php آشنایی داشته باشین میدونین که برای اعمال شرط تو کدنویسی ما از {{if}}, {{else}} و {{elseif}} استفاده میکنیم.

حالا نوبت میرسه به توضیحات اصلی:

نمونه 1:

این نوع شرطی میگه که اگه آیدی کار 3 بود کد اول رو اجرا کن و اگه 9 بود کد دوم رو و اگه هیچ کدوم از اینا نبود کد سوم رو اجرا کن

{{if member.member_id == 3}} 
     
{{elseif member.member_id == 9}} 
     
{{endif}}
یا
{{if \ IPS \ Member :: loggedIn () -> member_id}}
     
{{endif}}

نمونه 3:

این نوع شرطی میاد بررسی میکنه که اگه کاربر مهمان هستش کد زیر رو بهش نمایش بده/اجرا کن

{{if !member.member_id}} 
     
{{endif}} 
یا
{{if \ IPS \ Member :: loggedIn () -> member_id === NULL}}
     
{{endif}}

نمونه 4:

این نوع شرطی میاد بررسی میکنه که اگه آیدی کاربر یکی از اعداد 5 8 472 باشه کد براش نمایش داده بشه/اجرا شه

{{if in_array(member.member_id, array(5, 28, 472) )}} 
     
{{endif}}

نمونه 5:

این نوع شرطی میاد بررسی میکنه که اگه آیدی گروه کاربری 4 باشه کد براش نمایش داده بشه/اجرا شه

{{if member.inGroup('4')}} 
     
{{endif}}

نمونه 6:

این نوع شرطی میاد بررسی میکنه که اگه پستها یا همون ارسالهای کاربر بیشتر از 3 تا باشه کد براش نمایش داده بشه/اجرا شه

{{if member.member_posts > 3}} 
     
{{endif}}

نمونه 7:

این نوع شرطی میاد بررسی میکنه که اگه پستها یا همون ارسالهای کاربر کمتر از 3 تا باشه کد براش نمایش داده بشه/اجرا شه

{{if member.member_posts < 3}}
	
{{endif}}

نمونه 8:

این نوع شرطی میاد بررسی میکنه که اگه کاربر تو گروه مدیریت کل باشه کد براش نمایش داده بشه/اجرا شه (توجه کنین که اون کاربرایی رو که دسترسی مدیریت کل رو بهش دادین تو این شرطی بررسی میشه و شامل اونها هم هستش)

{{if member.isAdmin()}} 
     
{{endif}}

نمونه 9:

این نوع شرطی میاد بررسی میکنه که اگه کاربر بن شده باشه کد براش نمایش داده بشه/اجرا شه

{{if member.isBanned()}} 
     
{{endif}}

نمونه 10:

این نوع شرطی میاد بررسی میکنه که کاربر اگر از برنامه تالار استفاده میکنه این کد براش نمایش داده بشه/اجرا شه (برای استفاده برای سایر برنامه ها باید کلید اون برنامه رو داشته باشین)

{{if request.app== 'forums'}} 
     
{{endif}}

نمونه 11:

این نوع شرطی میاد بررسی میکنه که اگه کاربر از برنامه تالار استفاده میکنه و آیدی تالار 3 هست کد نمایش داده بشه/اجرا شه

{{if request.app == 'forums'  && request.module == 'forums'  && request.id == 3}} 
     
{{endif}}

نمونه 12:

این نوع شرطی میاد بررسی میکنه که اگه کاربر تو گروههای کاربری 2 4 یا 6 بود کد براش نمایش داده بشه/اجرا شه

{{if in_array (\ IPS \ Member :: loggedIn () -> member_group_id, array (2, 4, 6))}}
     
{{endif}}

نمونه 13:

این نوع شرطی میاد بررسی میکنه که اگه آیدی تالار 10 یا 13 باشه کد نمایش داده بشه/اجرا شه

{{if $ forum-> id == 13 OR $ forum-> id == 10}}
     
{{endif}}

نمونه 14:

این نوع شرطی میاد بررسی میکنه که اگه آیدی تالار 10 و 13 باشه کد نمایش داده بشه/اجرا شه

{{if in_array ($ forum-> id, array (10, 13))}}
     
{{endif}}

نمونه 15:

این نوع شرطی میاد بررسی میکنه که اگه برنامه مورد استفاده "downloads" باشه کد نمایش داده بشه/اجرا شه

{{if \ IPS \ Request :: i () -> app == "downloads"}}
     
{{endif}}

نمونه 16:

این نوع شرطی میاد بررسی میکنه که اگه قالب مورد استفاده آیدیش 1 باشه کد نمایش داده بشه/اجرا شه

{{if \IPS\Member::loggedIn()->skin == "1"}}
     
{{endif}}

نمونه 17:

این نوع شرطی میاد بررسی میکنه که اگه آیدی صفحات مورد استفاده 1 2 3 4 و 5 باشه کد نمایش داده بشه/اجرا شه

{{if \IPS\Request::i()->app == 'cms' and \IPS\Request::i()->controller == 'page' and \IPS\Request::i()->module == 'pages' and $page = \IPS\cms\Pages\Page::$currentPage and \in_array($page->id, array(1,2,3,4,5))}}
     
{{endif}}

نمونه 18:

این نوع شرطی میاد بررسی میکنه که اگه ماژول privacy باشه کد نمایش داده بشه/اجرا شه

{{if request.module === 'system' && request.controller === 'privacy'}}
     
{{endif}}

نمونه 19:

این نوع شرطی میاد بررسی میکنه که اگه کاربر زبان انتخابیش انگلیسی باشه کد نمایش داده بشه/اجرا شه

{{if \IPS\Member::loggedIn()->language()->bcp47() == 'en-US'}}
     
{{endif}}

نمونه 20:

این کد میاد بررسی میکنه که تنظیمات مقدار X رو داره یا نه که اگه داشت کد اجرا شه:

{{if settings.auto_polling_enabled}}
    
{{endif}}

نمونه 21:

این شرطی میاد بررسی میکنه که اگه مقدار متغیر فلان در قالب X بود کد اجرا شه: (بیت های قالب در IPS4 ممکن است یک یا چند متغیر را از کد پشتیبان دریافت کنند. این فقط در قالبی کار می کند که متغیری که بررسی می کنید به آن منتقل می شود)

{{if $myVariable == 'some_value'}}
    
{{endif}}

نمونه 22:

این نوع شرطی میاد بررسی میکنه که اگر از برنامه تالار استفاده میکنه و آیدی تالار عدد X هستش کد نمایش داده بشه:

{{if request.app == 'forums' && request.module == 'forums' && request.id ==X}}
    
{{endif}}

نمونه 23:

این نوع شرطی میاد بررسی میکنه که اگه قالب در حالت چپ پین (LTR) بود کد A رو نمایش بده و اگه در حالت راست چین (RTL) بود کد B رو نمایش بده:

{{if member.language()->isltr}}
A
{{else}}
B
{{endif}}

نمونه 24:

همچنان ادامه دارد....

آموزش نمایش/مخفی سازی قسمتهایی از انجمن با دستورهای CSS

Sat, 20 Mar 2021 09:29:54 +0000

سلام خدمت همه کاربران!

تو این آموزش قراره یاد بگیریم که چطور با استفاده از دستورهای CSS که خود انجمن داره ازش استفاده میکنه تو بخشهای دلخواه استفاده کنیم

برای مثال اگه همین انجمن رو نگا کنین تو صفحه اول کنار دکمه "ایجاد موضوع جدید" دکمه "قوانین ایجاد تاپیک" رو میبینین که این دکمه در حالت موبایل و تبلت نمایش داده نمیشه (البته میشه کاری کرد که فقط تو حالت دسکتاپ نمایش داده نشه)

خب اگه شماهم یک بخش رو ایجاد کردین که نمیخواین تو حالت موبایل نمایش داده بشه یا فقط میخواین تو حالت دسکتاپ نمایش داده بشه کافیه از کلاسهای css زیر استفاده کنین

/*مخفی سازی در حالت موبایل*/    
    ipsResponsive_hidePhone
/*مخفی سازی در حالت تبلت*/    
    ipsResponsive_hideTablet
/*مخفی سازی در حالت دسکتاپ*/    
    ipsResponsive_hideDesktop
/*نمایش در حالت موبایل*/    
    ipsResponsive_showPhone
/*نمایش در حالت تبلت*/    
    ipsResponsive_showTablet
/*نمایش در حالت دسکتاپ*/    
    ipsResponsive_showDesktop

مثال:

 class='ipsResponsive_hidePhone ipsResponsive_hideTablet'>
محتوای کد نویسی شما

این کلاس میاد محتوای کدهای شما رو در حالت موبایل و تبلت مخفی میکنه

امیدوارم موفق باشید!

آموزش تغییر زبان محتوای کدنویسی بر حسب زبان کاربر

Sun, 27 Dec 2020 11:41:20 +0000

سلام خدمت تمامی کاربران

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

برای این کار کافیه کدهای مورد نظرتون رو داخل این کد شرطی PHP قرار بدین:

{{$lang = \IPS\Member::loggedIn()->language()->short;}}
{{if mb_strpos($lang, 'fa_ir') === 0}}
محتوای کدنویسی شده
{{elseif mb_strpos($lang, 'en_us') === 0}}
...افزودن زبانهای بیشتر
{{else}}
پایان محتوا
{{endif}}

امیدوارم موفق باشید!

آموزش مخفی کردن قسمتهایی از انجمن از دید کاربر مهمان

Sat, 26 Dec 2020 11:45:06 +0000

سلام خدمت تمامی کاربران

تو این آموزش میخوام بهتون یاد بدم که چطور در کدنویسی بخشی از انجمن رو که نمیخواین کاربر مهمان ببینه مخفی کنین

کافیه موقع کدنویسی یا ایجاد ابزارک کدهاتون رو داخل کد شرطی زیر قرار بدین:

{{if \IPS\Member::loggedIn()->member_id}}
محتویات کد
{{endif}}

امیدوارم موفق باشید!