1- پنل کاربری
هر کاربر بعد از لاگین شدن در سایت میتواند پنل کاربری خود را مشاهده کند. بر اساس نوع سایت میتوان امکانات مختلفی را در آن قرار داد. یکی از مواردی که در تمام سایت ها قابل استفاده میباشد بخش اطلاعات کاربری است.
1-1- نمایش اطلاعات کاربر
دستور زیر اطلاعات کاربر را در سایت فراخوانی میکند :
خروجی:
خروجی این دستور، شامل فیلدهای زیر میباشد :
valueID : آی دی رکورد ثبت شده در دیتابیس
prpid : آی دی مشخصه ی اسکمای کاربر
usedforid : آی دی کاربر
typeid : آی دی نوع مشخصه ی اسکمای کاربر
multi : فیلد مشخص کننده اینکه این مشخصه از اسکما میتواند بیش از یک پاسخ داشته باشد (1 : بله - 0 : خیر)
question : عنوان مشخصه اسکمای کاربر
answer : پاسخ مشخصه
1-2- ویرایش اطلاعات کاربری
با استفاده از دستور زیر میتوان اطلاعات کاربر را ویرایش نمود :
خروجی:
خروجی این دستور یک داده واحد بصورت زیر میباشد :
column1 : بعد از ثبت اطلاعات مقدار ok خواهد داشت.
1-3- تغییر رمز عبور کاربر
با استفاده از دستور زیر کاربر میتواند رمز عبور خود را تغییر دهد :
خروجی:
خروجی این دستور، یک رکورد شامل فیلدهای زیر میباشد :
rkey : کد منحصر به فرد که با لاگین در سایت به کاربر تعلق می گیرد.
Error : این فیلد مشخص کننده آن است که در تغییر رمز خطایی رخ داده یا خیر. اگر مقدار آن true باشد به این معناست که تغییر با موفقیت انجام شده است. ولی در صورتی که عملیات به درستی انجام نشود، متن خطای رخ داده ، در این فیلد نمایش داده خواهد شد.
Url : آدرس صفحه‌ای که میخواهیم بعد از انجام عملیات، کاربر را به آن صفحه منتقل کنیم. (این مقدار در صورتی مقدار خواهد داشت که در ورودی فیلد referer مقدار دهی شده باشد.)
2- آدرس و شماره تماس کاربر
کاربرد این دستورات معمولا در سایت های فروشگاهی میباشد. اطلاعات آدرس و تلفنی که کاربر در مراحل سفارش آن را ثبت کرده است با استفاده از دستورات زیر قابل نمایش است.
2-1- لیست آدرس های کاربر و تلفن های ثبت شده برای هر کدام
دستور زیر لیست آدرس های کاربر را در سایت فراخوانی میکند. در صورتیکه مقدار id در ورودی ارسال شود، تنها آدرس با آی دی مورد نظر، فراخوانی خواهد شد. کاربرد این دستور در پنل کاربری سایت های فروشگاهی و در مراحل ثبت سفارش در فروشگاه الکترونیکی میباشد :
خروجی:
خروجی این دستور، لیستی شامل فیلدهای زیر میباشد :
id : آی دی مربوط آدرس
userid : آیدی کاربر
countryCode : نام کشور
countryCodeid : آی دی کشور
cityCode : نام شهر
cityCodeid : آی دی شهر
neighberhood : نام منطقه
neighberhoodid : آی دی منطقه
areaCode : نام استان
areaCodeid : آی دی استان
postalcode : کد پستی
cellphone : شماره همراه کاربر
phone : شماره تماس ثابت
3- فاکتورها
با استفاده از دستورات این بخش میتوان اطلاعات مربوط به تمام فاکتورهای یک کاربر، وضعیت و جزئیات هر یک را مشاهده نمود.
3-1- لیست فاکتورها
دستور زیر لیست فاکتورهای کاربر در یک سایت را فراخوانی میکند :
خروجی:
خروجی این دستور، لیستی شامل فیلدهای زیر میباشد :
id : شماره فاکتور
user : آی دی کاربر
CalculatedSalePriceSum : مبلغ کل قبل از تخفیف
PayPrice : مبلغ قابل پرداخت
opendate : تاریخ باز شدن فاکتور
Finished : نشان دهنده وضعیت فاکتور می باشد. اگر مقدار آن یک باشد یعنی فاکتور بسته شده است و اگر صفر باشد به معنی باز بودن فاکتور می باشد.
Address : آی دی آدرس کاربر
Trace : آی دی روش ارسال سفارش
pay : آی دی روش پرداخت سفارش
3-2- لیست سفارشات یک فاکتور
دستور زیر لیست سفارشات ثبت شده در یک فاکتور را فراخوانی میکند :
خروجی:
خروجی این دستور لیستی شامل فیلد های زیر می باشد :
id : آی دی محصول
pID : آی دی تنوع انبار
mid : آی دی نوع مشخص کننده نوع شیء
Count : تعداد
SailPrice : قیمت واحد
titel : عنوان سفارش
Dmn_id : آی دی هاست
Calculate : مبلغ کل
3-3- روش ارسال ثبت شده در یک فاکتور
دستور زیر روش ارسال ثبت شده برای یک فاکتور را فراخوانی میکند :
خروجی:
خروجی این دستور یک رکورد شامل فیلدهای زیر می باشد :
Price : هزینه ارسال
description : توضیحات
title : عنوان روش ارسال
3-4- روش پرداخت ثبت شده در یک فاکتور
دستور زیر روش پرداخت ثبت شده برای یک فاکتور را فراخوانی میکند :
خروجی:
خروجی این دستور یک رکورد شامل فیلدهای زیر می باشد :
price : هزینه ثبت شده برای روش پرداخت
description : توضیحات
title : عنوان روش پرداخت
3-5- لیست وضعیت های فاکتور
در صورتیکه وضعیت فاکتور در دپارتمان های موجود ثبت شده باشد، میتوان آن را نمایش داد. برای نمونه اگر فروشگاه الکترونیک دپارتمان با نام "ارسال" را ایجاد کرده باشد و وضعیت هایی مانند "ارسال شده" و یا "تحویل شده" تعریف کرده باشد، میتواند بعد از هر مرحله از ارسال، وضعیت فاکتور کاربر را مشخص کند. دستور زیر لیست وضعیت های ثبت شده برای یک فاکتور در یک یا چند دپارتمان را فراخوانی میکند :
خروجی:
خروجی این دستور لیستی شامل فیلد های زیر می باشد :
id : آی دی دپارتمان
title : عنوان دپارتمان
statusid : آی دی وضعیت ثبت شده
stitle : وضعیت ثبت شده
note : توضیحات
commentdate : تاریخ و زمان ثبت وضعیت
3-6- لیست دپارتمان ها
دستور زیر لیست دپارتمان های موجود برای یک شرکت را در سایت فراخوانی میکند :
خروجی:
خروجی این دستور لیستی شامل فیلدهای زیر می باشد :
id : آی دی نظر دپارتمان
title : نام دپارتمان
3-7- نمایش زمان ارسال سفارش - ارسال و یا عدم ارسال فاکتور به همراه سفارش
درصورتیکه برای فاکتوری، در خواست کاربر در خصوص ارسال و یا عدم ارسال فاکتور به همراه سفارش و تعیین روز ارسال سفارش، ثبت شده باشد، دستور زیر این اطلاعات را در سایت فراخوانی میکند :
خروجی:
خروجی دستور یک فیلد واحد بصورت زیر میباشد :
configuration : خروجی این دستور یک جیسون است، که میتواند شامل اطلاعات ارسال و یا عدم ارسال فاکتور به همراه کالا، و زمان ارسال سفارش باشد. نمونه ای از این این جیسون بصورت زیر میباشد :
{"sendfactor": "1","sendtime": {"id": "3","days": "یکشنبه","hours": "3-6","price": "100"}}
فیلد sendfactor مشخص کننده ارسال (1) و یا عدم ارسال فاکتور (0) به همراه سفارش میباشد.
آبجکت sendtime مربوط به جزئیات زمان پرداخت میباشد که فیلدهای آن شامل آی دی زمان پرداخت انتخاب شده، روز و ساعت و هزینه ی آن میباشد.
4- نظرات
4-1- لیست نظرات کاربر
دستور زیر لیست نظرات تایید شده در یک سایت را فراخوانی میکند. در صورتیکه ورودی های userid (آی دی کاربر) و یا usedforid (آی دی شیء) ارسال شود، لیست نظرات ثبت شده توسط یک کاربر و یا لیست نظرات ثبت شده برای یک شیء فراخوانی میگردد.
خروجی:
خروجی این دستور لیستی شامل فیلدهای زیر می باشد :
id : آی دی نظر ثبت شده
parentid : آی دی والد نظر ثبت شده (در صورتی که مقدار این فیلد برابر با 0 باشد به این معنی است که این نظر در پاسخ به نظر دیگری ثبت نشده است. در صورتی که نظر ثبت شده، پاسخ به نظر دیگری باشد، آی دی آن نظر در این فیلد قرار خواهد گرفت)
usedforid : آی دی شی ء که نظر برای آن ثبت شده است.
mid : آی دی مشخص کننده نوع شیء
comment : متن نظر
userid : آی دی کاربر
username : نام کاربر که در زمان ثبت نظر وارد شده است
createdate : تاریخ ثبت نظر
approve : فیلد مشخص کننده ی اینکه این نظر توسط ادمین سایت تایید شده است یا خیر (تایید شده:1، تایید نشده :0)
like : تعداد like های ثبت شده برای شیء که نظر برای آن ثبت شده است.
dislike : تعداد dislike های ثبت شده برای شیء که نظر برای آن ثبت شده است.
title : نام شیء که نظر برای آن ثبت شده است.
link : در صورتی که برای یک شیء در زبان مورد نظر، لینک مجازی تعریف شده باشد، لینک مجازی و در غیر اینصورت مقدار null خواهد داشت.
4-2- نمایش نظر کاربر
دستور زیر جزئیات نظر ثبت شده را در سایت فراخوانی میکند :
خروجی:
خروجی این دستور یک رکورد شامل فیلدهای زیر می باشد :
id : آی دی نظر ثبت شده
parentid : آی دی والد نطر ثبت شده. (در صورتی که کاربر این نطر را در پاسخ به نظر فرد دیگری داده باشد، آی دی آن نظر در این فیلد قرار میگیرد)
usedforid : آی دی شیء
mid : آی دی مشخص کننده نوع شیء
comment : متن نظر
createdate : تاریخ ثبت نظر
approve : درصورتی که نظر ثبت شده، توسط ادمین برای نمایش در سایت، تایید شده باشد مقدار آن یک و در غیر اینصورت مقدار آن صفر است.
5- علاقه مندی ها
5-1- لیست علاقه مندی های کاربر
دستور زیر لیست علاقه مندی های کاربر را فراخوانی میکند :
خروجی:
خروجی این دستور لیستی شامل فیلدهای زیر می باشد :
id : آی دی رکورد ثبت شده
userid : آی دی کاربر
usedforid : آی دی شیء
mid : آی دی مشخص کننده نوع شیء
dmnid : آی دی هاست
enableid : فیلد مربوط به فعال یا غیر فعال بودن رکورد علاقه مندی (0 : غیر فعال - 1 : فعال)
5-2- حذف یک آبجکت از علاقه مندی ها
با استفاده از دستور زیر میتوان یک شیء را از لیست علاقه مندی های کاربر حذف نمود :
خروجی:
خروجی دستور یک فیلد واحد بصورت زیر میباشد :
Column1 : با حذف شیء از علاقه مندی ها مقدار ok برگردانده میشود
