۴
شهریور

جلسه ۲۲ : افزودن ارسال کننده اطلاعات شخصی به پلاگین

دسته‌بندی‌ها :

جزئیات
نوع محتواآموزشی

فهرست

مقدمه

با عرض سلام و وقت به خیر خدمت کاربران سایت پی وی لرن به ویژه کاربرانی که به سیستم مدیریت محتوای قدرتمند وردپرس علاقمند هستند.
به ” دوره متخصص وردپرس ” خوش آمدید!
در این دوره قرار است توسعه و ارتقاء پلاگین های وردپرس را به صورت جامع و کامل بیاموزیم.
فرقی نمی کند که در شرف نوشتن اولین پلاگین خود هستید و یا این که پنجاهمین پلاگین خود را می نویسید! امیدوارم این دوره برایتان مفید باشد.
در جلسه گذشته با سیاست های حفظ حریم خصوصی آشنا شدیم.
در این جلسه می آموزیم که چگونه می توان به افزودن ارسال کننده اطلاعات شخصی به پلاگین پرداخت.

افزودن ارسال کننده اطلاعات شخصی به پلاگین

در وردپرس ۴٫۹٫۶، ابزاری برای تطابق با قوانینی مانند مقررات حفاظت کلی داده های اتحادیه اروپا یا GDPR برای مدت کوتاهی اضافه شده بود.
این ابزار، یک ابزار برای ارسال داده های شخصی به صورت یک فایل زیپ ZIP است.
افزودن ارسال کننده اطلاعات شخصی به پلاگین علاوه بر ارسال داده های شخصی کاربران در موارد دیگری نیز کاربرد دارد.
این موارد می توانند نظرات وردپرس، افزونه ها و … باشند.

کلید دریافت داده های شخصی کاربران چیزی نیست جز آدرس ایمیل آن ها.
اما چرا آدرس ایمیل کاربران؟
آدرس ایمیل کاربران از ان جهت که هم از کاربران ثب شده و هم کاربران ثبت نشده پشتیبانی می کند؛ منبع خوبی است.

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

بررسی کلیه موارد در داده های شخصی

مدیر درخواست ثبت کاربران را با داشتن نام کاربری و آدرس ایمیل آن ها بررسی می کند.
بعد از بررسی نام کاربری و آدرس ایمیل کاربران، تاییدیه ثبت آن ها به ایمیل شان ارسال می شود.

هنگامی که یک درخواست تایید شده است، مدیر می تواند فایل ZIP ارسال شده فایل شخصی را برای کاربر تولید و دانلود یا به طور مستقیم از آن برای ارسال ایمیل شخصی استفاده کند.
در داخل این فایل زیپ، کاربر یک “mini website” به همراه یک صفحه HTML ایندکس شده که حاوی داده سازمان یافته شخصی است؛ دریافت می کند.

این که مدیر فایل ZIP حاوی اطلاعات شخصی را دانلود کند و یا به طور مستقیم به درخواست کننده بفرستد بستگی به شرایط دارد.
در واقع این امر بستگی به هوک کردن “exporter” که کلیه داده ها را جمع آوری می کند؛ وابسته است.

هنگامی که مدیر بر روی لینک دانلود یا ایمیل کلیک می کند، یک حلقه AJAX شروع به کار می کند.
این حلقه، برای کلیه ارسال کننده های ثبت شده در سیستم فعال می شود.
علاوه بر این ارسال کنندهای ساخته شده در هسته، می توانند فراخوان های ارسال کننده خود را ثبت نمایند.

سادگی طراحی تابع فراخوان ارسال کننده

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

یک پلاگین خوب میزان داده هایی را که در هر صفحه پاک می شود (مثلا ۱۰۰ پست، ۲۰۰ نظر و غیره) را محدود می کند.

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

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

هر آیتم حاوی گروهی از identifier ها است. مانند (پست ها، درخواست ها و غیره).

توجه کنید که کقدار باید در صفحه HTML index یک media path (مسیر رسانه) باشد.

هنگامی که همه ارسال کنند ها برای تکمیل فراخوانی شده اند، وردپرس ابتدا یک سند HTML «فهرست» را که قلب گزارش ارسال کننده است، گزارش می کند.

اگر یک افزونه اطلاعات اضافی را برای یک آیتم که وردپرس و یا یک افزونه دیگر در آن اضافه کرده است گزارش کند، تمام اطلاعات مربوط به آن مورد با هم ارائه می شوند.

ارسال به مدت ۳ روز در سرور ذخیره شده و سپس حذف می شود.

چگونه به افزودن ارسال کننده اطلاعات شخصی به پلاگین بپردازیم؟

یک پلاگین می تواند یک یا چند ارسال کننده را ثبت کند.
اما اکثر پلاگین ها تنها به یک مورد نیاز دارند.
اجازه دهید کار با یک افزونه فرعی که داده های مکان را برای نظر دهنده به نظرات اضافه می کند شروع کنیم.

اولا فرض کنید که افزونه از ‘add_comment_meta` برای اضافه کردن اطلاعات مکان با استفاده از meta_key از عرض جغرافیایی و طول جغرافیایی استفاده کرده است.

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

مثال :

function my_plugin_exporter( $email_address, $page = 1 ) {
  $number = 500; // Limit us to avoid timing out
  $page = (int) $page;
 
  $export_items = array();
 
  $comments = get_comments(
    array(
      'author_email' => $email_address,
      'number' => $number,
      'paged' => $page,
      'order_by' => 'comment_ID',
      'order' => 'ASC',
    )
  );
 
  foreach ( (array) $comments as $comment ) {
    $latitude = get_comment_meta( $comment->comment_ID, 'latitude', true );
    $longitude = get_comment_meta( $comment->comment_ID, 'longitude', true );
 
    // Only add location data to the export if it is not empty
    if ( ! empty( $latitude ) ) {
      // Most item IDs should look like postType-postID
      // If you don't have a post, comment or other ID to work with,
      // use a unique value to avoid having this item's export
      // combined in the final report with other items of the same id
      $item_id = "comment-{$comment->comment_ID}";
 
      // Core group IDs include 'comments', 'posts', etc.
      // But you can add your own group IDs as needed
      $group_id = 'comments';
 
      // Optional group label. Core provides these for core groups.
      // If you define your own group, the first exporter to
      // include a label will be used as the group label in the
      // final exported report
      $group_label = __( 'Comments' );
 
      // Plugins can add as many items in the item data array as they want
      $data = array(
        array(
          'name' => __( 'Commenter Latitude' ),
          'value' => $latitude
        ),
        array(
          'name' => __( 'Commenter Longitude' ),
          'value' => $longitude
        )
      );
 
      $export_items[] = array(
        'group_id' => $group_id,
        'group_label' => $group_label,
        'item_id' => $item_id,
        'data' => $data,
      );
    }
  }
 
  // Tell core if we have more comments to work on still
  $done = count( $comments ) < $number;
  return array(
    'data' => $export_items,
    'done' => $done,
  );
}

function my_plugin_exporter( $email_address, $page = 1 ) {

$number = 500; // Limit us to avoid timing out

$page = (int) $page;

$export_items = array();

$comments = get_comments(

array(

'author_email' => $email_address,

'number' => $number,

'paged' => $page,

'order_by' => 'comment_ID',

'order' => 'ASC',

)

);

foreach ( (array) $comments as $comment ) {

$latitude = get_comment_meta( $comment->comment_ID, 'latitude', true );

$longitude = get_comment_meta( $comment->comment_ID, 'longitude', true );

// Only add location data to the export if it is not empty

if ( ! empty( $latitude ) ) {

// Most item IDs should look like postType-postID

// If you don't have a post, comment or other ID to work with,

// use a unique value to avoid having this item's export

// combined in the final report with other items of the same id

$item_id = "comment-{$comment->comment_ID}";

// Core group IDs include 'comments', 'posts', etc.

// But you can add your own group IDs as needed

$group_id = 'comments';

// Optional group label. Core provides these for core groups.

// If you define your own group, the first exporter to

// include a label will be used as the group label in the

// final exported report

$group_label = __( 'Comments' );

// Plugins can add as many items in the item data array as they want

$data = array(

array(

'name' => __( 'Commenter Latitude' ),

'value' => $latitude

array(

'name' => __( 'Commenter Longitude' ),

'value' => $longitude

)

);

$export_items[] = array(

'group_id' => $group_id,

'group_label' => $group_label,

'item_id' => $item_id,

'data' => $data,

);

}

// Tell core if we have more comments to work on still

$done = count( $comments ) < $number;

return array(

'data' => $export_items,

'done' => $done,

);

}

کاری که افزونه باید انجام دهد این است که با فراخوانی آرایه ارسال کننده با استفاده از فیلتر wp_privacy_personal_data_exporters فیلتر فراخوانی را ثبت کند.

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

مثال :

function register_my_plugin_exporter( $exporters ) {
  $exporters['my-plugin-slug'] = array(
    'exporter_friendly_name' => __( 'Comment Location Plugin' ),
    'callback' => 'my_plugin_exporter',
  );
  return $exporters;
}
 
add_filter(
  'wp_privacy_personal_data_exporters',
  'register_my_plugin_exporter',
  10
);

function register_my_plugin_exporter( $exporters ) {

$exporters['my-plugin-slug'] = array(

'exporter_friendly_name' => __( 'Comment Location Plugin' ),

'callback' => 'my_plugin_exporter',

);

return $exporters;

}

add_filter(

'wp_privacy_personal_data_exporters',

'register_my_plugin_exporter',

);

بفرمایید تمام مواردی را که لازم بود انجام داده ایم.
حالا پلاگین شما برای ارسال آماده است!

کلام آخر

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

QR: جلسه ۲۲ : افزودن ارسال کننده اطلاعات شخصی به پلاگین

به اشتراک بگذارید

دیدگاه کاربران

تعداد دیدگاه : 0

پی وی لرن – آموزش برنامه نویسی و طراحی وب سایت

دوره های آموزشی آکادمی پی وی لرن (پروژه محور و ویژه بازار کار)

جلسه ۲۲ : افزودن ارسال کننده اطلاعات شخصی به پلاگین

مقدمه

افزودن ارسال کننده اطلاعات شخصی به پلاگین

بررسی کلیه موارد در داده های شخصی

سادگی طراحی تابع فراخوان ارسال کننده

چگونه به افزودن ارسال کننده اطلاعات شخصی به پلاگین بپردازیم؟

کلام آخر

لیست مطالب دوره

اصول اولیه پلاگین نویسی در وردپرس

امنیت پلاگین ها

هوک ها

حریم خصوصی

منو های مدیریت

تنظیمات پلاگین

انواع پست های سفارشی (Post Types)

دسته بندی ها در ساخت پلاگین

JavaScript

Internationalization (بین المللی سازی)

قوانین و دستور العمل های ایجاد پلاگین

ابزارهای توسعه دهنده پلاگین

مطالب ویژه

دسته های اصلی

برگه ها

بلاگ