النشر عبر الواجهة الأمامية: التعديل والحذف

() translation by (you can also view the original English article)

اليوم، نحن سوف نتواصل مع شركائنا في سلسلة مصغرة للمشاركة في الادراج عبر الواجهة الأمامية ولكن في هذا الجزء سوف ننظر حصريا في كيفية تعديل و حذف المشاركات عبر الواجهة الأمامية. سنغطي كيفية عرض جميع مشاركاتنا وتعديلها وحذفها. لذلك ، دعونا نستعد ونبدأ!

المقدمة

نحن الآن في الجزء الثاني من مسلسلنا الصغير ، وإذا لم تكن قد قرأت الجزء الأول ، فأنا أنصحك بذلك لأننا سوف نبدأ من حيث توقفنا. يجب أن يسمح هدفنا بعد إكمال هذه السلسلة الصغيرة للمستخدم بإرسال المشاركات عبر الواجهة الأمامية ، إلى جانب تحرير وإرسال المشاركات إلى المهملات ؛ كل ذلك دون أن تكون في لوحة معلومات WordPress. يمكن استخدام هذه الطرق في كل من الموضوع أو البرنامج المساعد وتكون قابلة للتكيف للغاية لتحقيق عمليات متقدمة للغاية ومعقدة.

الملفات التجريبية والملفات التي تم تنزيلها هي عبارة عن موضوع مُعطل تم إنشاؤه لأغراض هذا البرنامج التعليمي فقط.

لذا افتح محرر النصوص المفضل ودعنا نبدأ!

الخطوة 1 عرض مشاركاتنا

سنبدأ بعرض جميع مشاركاتنا بشكل أكثر فعالية ، وهذا سيعطينا إدارة أفضل على مشاركاتنا ويسمح لنا بتنفيذ إجراءات على كل مشاركة. نظرًا لأننا نستخدم السمة لتطوير هذا ، فسننشئ قالب صفحة يسمى template-view-posts.php . كما سنقوم بإنشاء صفحة جديدة عبر صفحات لوحة أدوات WordPress الخاصة بنا -> إضافة جديد -> سمات الصفحة كتعريف القالب لهذه الصفحة.

لدينا الآن نموذج صفحة و صفحة تم إنشاؤها في موضوع WordPress الخاص بنا ، يمكننا البدء في إخراج جميع مشاركاتنا. . سنقوم بإنشاء جدول بسيط جدًا لإخراج جميع المعلومات الضرورية. ابدأ بإنشاء جدول يحتوي على بعض العناوين ، على النحو التالي:

1
2
3	<table>
4
5	<tr>
6	<th>Post Title</th>
7	<th>Post Excerpt</th>
8	<th>Post Status</th>
9	<th>Actions</th>
10	</tr>
11
12	<tr>
13	<td></td>
14	<td></td>
15	<td></td>
16	<td></td>
17	</tr>
18
19	</table>

والآن بعد أن أصبح لدينا طاولتنا ، يمكننا البدء في ملء صفوف جدولنا بمعلومات تتعلق بمشاركاتنا. سنبدأ أولاً بإنشاء حلقة ووردبريس مخصصة ، لضمان حصولنا على جميع المشاركات وجميع حالات النشر ، لأننا نريد أن نكون قادرين على رؤية المشاركات المعلقة ، أو المسودات ، أو المنشورة ، أو حتى المرسلة إلى المهملات. نقوم بذلك عن طريق إدخال الجزء التالي من التعليمات البرمجية:



<?php
$query = new WP_Query( array(
	'post_type' => 'post',
	'posts_per_page' => '-1',
	'post_status' => array(
		'publish',
		'pending',
		'draft',
		'private',
		'trash'
	)
) );
?>

هذا هو كائن الاستعلام الخاص بنا مع جميع المعلمات المخصصة التي قمنا بتعيينها. يمكنك أن تقرأ عن جميع المعلمات المختلفة التي يمكننا وضعها من وورد كوديكس . . بعد ذلك ، سنقوم بتشغيل حلقة WordPress بعد عناوين جدولنا مباشرة ، على النحو التالي:

1
2
3	<?php
4	if ( $query->have_posts() ) : while ( $query->have_posts() ) : $query->the_post(); ?>
5
6	<tr>
7	<td></td>
8	<td></td>
9	<td></td>
10	<td></td>
11	</tr>
12
13	<?php endwhile; endif; ?>

متألق! لدينا مجموعة جداول ، و لدينا مجموعة حلقة وورد. والآن نحتاج فقط إلى إدخال معلوماتنا المتعلقة بعناوين الجداول الخاصة بنا. استبدل خلايا الجدول الفارغة بالرمز التالي:

1
2
3	<tr>
4	<td><?php echo get_the_title(); ?></td>
5	<td><?php the_excerpt(); ?></td>
6	<td><?php echo get_post_status( get_the_ID() ) ?></td>
7	<td><a href="#">Edit</a> <a href="#">Delete</a></td>
8	</tr>

يبدأ الرمز الذي قمنا بإدراجه أولاً بإخراج عنوان المنشور الخاص بنا ، والعنصر التالي هو إخراج مقتطف من المنشور. ثم نحصل على الحالة الحالية للنشرة ونمرر معرف المشاركة إلى هذه الوظيفة وأخيرًا ، ندخل رابطان تعديل وحذف ، سنستخدمها لاحقًا كإجراءاتنا.

الخطوة 2 تحرير مشاركاتنا

رائع ، نحن نحرز تقدما جيدا. لقد أنشأنا موضوعنا لعرض جميع مشاركاتنا عبر الواجهة الأمامية. بعد ذلك ، سنقوم بتحرير المشاركة. نبدأ هذا عن طريق إنشاء قالب صفحة آخر يسمىtemplate-edit-posts.php . أيضًا ، سننشئ صفحة جديدة عبر صفحات لوحة أدوات WordPress الخاصة بنا -> إضافة جديد -> سمات الصفحة وتعيين القالب إلى هذه الصفحة.

قبل أن نبدأ في تحرير هذا القالب ، دعنا نرجع مرة أخرى إلى ملف template-view-posts.php الخاص بنا ، ونتأكد من أننا نمرر معرف المشاركة إلى عنوان URL حيث سنقوم باسترداد المعرف من صفحة التعديل الخاصة بنا. نقوم بذلك باستخدام وظيفة WordPress: add_query_arg . سنقوم بإدراج الشفرة التالية قبل رابط التعديل الخاص بنا مباشرةً:



<?php
$edit_post = add_query_arg( 'post', get_the_ID(), get_permalink( 61 + $_POST['_wp_http_referer'] ) );
?>

الرمز الذي أدخلناه للتو ، يعيّن أولاً اسم المعلمة ، ثم يلي ذلك الحصول على معرف المنشور ، ثم نحصل على معرف قالب تحرير الصفحة الخاص بنا وإضافة وسيطة عنوان URL المخصصة الخاصة بنا. سنستخدم هذا لاسترداد المعلومات في قالب التعديل الخاص بنا.

أخيرًا ، سنقوم بإخراج ذلك في رابط التعديل الخاص بنا ، مما يجعل رابط التعديل الخاص بنا كما يلي:

1
2
3	<a href="<?php echo $edit_post; ?>">Edit</a>

. والآن بعد أن تم تعيينه عندما ينقر المستخدم على "تعديل" ، فإنه ينتقل إلى "تعديل النموذج" باستخدام "معرّف المشاركة". سوف نعود إلى ملف template-edit-posts.php الخاص بنا ونبدأ في إدخال الكود الخاص بنا.

سنقوم بنسخ النموذج الخاص بنا من template-insert-posts.php الخاص بنا وإدخاله في "قالب التعديل" الخاص بنا. نحن نقوم بنسخ التعليمة البرمجية التالية إلى قالب التعديل الخاص بنا ، وإزالة كافة القيم من مدخلاتنا و textarea ، مما يجعل النموذج الخاص بنا كما يلي:



<form action="" id="primaryPostForm" method="POST">

	<fieldset>

		<label for="postTitle"><?php _e( 'Post\'s Title:', 'framework' ); ?></label>

		<input type="text" name="postTitle" id="postTitle" value="" class="required" />

	</fieldset>

	<?php if ( $postTitleError != '' ) { ?>
		<span class="error"><?php echo $postTitleError; ?></span>
		<div class="clearfix"></div>
	<?php } ?>

	<fieldset>
				
		<label for="postContent"><?php _e( 'Post\'s Content:', 'framework' ); ?></label>

		<textarea name="postContent" id="postContent" rows="8" cols="30"></textarea>

	</fieldset>

	<fieldset>
		
		<?php wp_nonce_field( 'post_nonce', 'post_nonce_field' ); ?>

		<input type="hidden" name="submitted" id="submitted" value="true" />
		<button type="submit"><?php _e( 'Add Post', 'framework' ); ?></button>

	</fieldset>

</form>

والآن بعد أن تم تعيين نموذج تعديل الصفحة ، سنحتاج إلى استخدام حلقة WordPress لمتابعة كل مشاركاتنا والعثور فقط على مشاركاتنا التي تطابق معرف المشاركة الذي تم تمريره إلى عنوان URL الخاص بنا. سنقوم بذلك عن طريق تشغيل حلقة WordPress في أعلى ملفنا:



<?php $query = new WP_Query( array( 'post_type' => 'post', 'posts_per_page' => '-1' ) ); ?>

<?php if ( $query->have_posts() ) : while ( $query->have_posts() ) : $query->the_post(); ?>

<?php

	/*
		We will be inserting all of our information inside of here
	*/

?>

<?php endwhile; endif; ?>
<?php wp_reset_query(); ?>

بالنسبة لحلقة WordPress للتأكد من أننا نقوم باسترداد معلومات المنشور المحدد فقط ، سنقوم بإدراج التعليمة البرمجية التالية التي تضمن حصولنا على معرف المشاركة الصحيح ، داخل الحلقة الخاصة بنا:



if ( isset( $_GET['post'] ) ) {
	
	if ( $_GET['post'] == $post->ID )
	{
		$current_post = $post->ID;
	}
}

ما قمنا بإدراجه للتو هو الحصول على معلمة URL واختبارها مقابل معرف المشاركة ، وعندما يعثر على تطابق ، سنقوم بتعيين هذا المعرّف إلى متغير current_post الخاص بنا . وبعد هذا سنقوم بإدراج بعض التعليمات البرمجية للحصول على معلومات لدينا فيما يتعلق مركزنا، إدراج التعليمة البرمجية التالية أدناه فقط لدينا current_postالمهمة:

1
2
3	$title = get_the_title();
4	$content = get_the_content();

يجب أن يكون رمزنا النهائي كما يلي:



if ( isset( $_GET['post'] ) ) {
	
	if ( $_GET['post'] == $post->ID )
	{
		$current_post = $post->ID;
		$title = get_the_title();
		$content = get_the_content();
	}
}

هذا رائع ، نحن نحرز تقدما جيدا. والآن بعد أن أصبح لدينا جميع معلوماتنا ، نحتاج فقط إلى إدخالها في قيم النماذج لدينا ، وهذا بسيط حيث سنقوم بتعيين قيم لكل من حقلينا. جنبا إلى جنب مع هذا سنقوم بتحديث اسم زرنا لتحديث البوست . التعليمة البرمجية التالية هي النموذج المحدّث الخاص بنا مع النموذج الملصق بعنوان المشاركة ومحتوى منشور التعديل:



<form action="" id="primaryPostForm" method="POST">

	<fieldset>

		<label for="postTitle"><?php _e( 'Post\'s Title:', 'framework' ); ?></label>

		<input type="text" name="postTitle" id="postTitle" value="<?php echo $title; ?>" class="required" />

	</fieldset>

	<?php if ( $postTitleError != '' ) { ?>
		<span class="error"><?php echo $postTitleError; ?></span>
		<div class="clearfix"></div>
	<?php } ?>

	<fieldset>
				
		<label for="postContent"><?php _e( 'Post\'s Content:', 'framework' ); ?></label>

		<textarea name="postContent" id="postContent" rows="8" cols="30"><?php echo $content; ?></textarea>

	</fieldset>

	<fieldset>
		
		<?php wp_nonce_field( 'post_nonce', 'post_nonce_field' ); ?>

		<input type="hidden" name="submitted" id="submitted" value="true" />
		<button type="submit"><?php _e( 'Update Post', 'framework'); ?></button>

	</fieldset>

</form>

كما ترون من الشفرة ، فقد خصصنا قيمة مدخلاتنا في عنوان البريد لإخراج متغير العنوان ، وداخل الجزء الخاص بنا قد قمنا بإخراج متغير المحتوى الخاص بنا ، ولكن كما لاحظت أنه عند النقر فوق تحديث نشر لا يحدث شيء ، لأننا لم نتعامل مع هذا بعد ، وسنفعل هذا الآن.

سنحتاج إلى الرجوع إلى ملف template-insert-posts.php الخاص بنا وسوف نقوم بنسخ نموذج التحقق من صحة PHP الخاص بنا إلى نموذج التعديل الخاص بنا. الآن بعد أن قمنا بنسخ المصادقة على النموذج ، سنقوم بإجراء بعض التغييرات وإدخال بعض التعليمات البرمجية. نحتاج إلى استرداد متغيرcurrent_post في نموذج التحقق من الصحة ، ونقوم بذلك عن طريق تعيين متغير عام ، ونحن نضيف هذا أعلاه إلى التحقق من صحتنا:

1
2
3	global $current_post;

بعد ذلك ، سنجري تعديلًا على مصفوفة post_information الخاصة بنا . أثناء قيامنا بتحديث المنشور الخاص بنا ، نحتاج إلى التأكد من أنه سيقوم بتحديث النشر الصحيح وليس كل المشاركات ، نقوم بذلك عن طريق إدخال معلمة معرف في مصفوفة post_information الخاصة بنا . جعل مصفوفاتنا على النحو التالي:



$post_information = array(
	'ID' => $current_post,
	'post_title' =>  wp_strip_all_tags( $_POST['postTitle'] ),
	'post_content' => $_POST['postContent'],
	'post_type' => 'post',
	'post_status' => 'pending'
);

أخيرًا ، سنجري تعديلًا نهائيًا واحدًا سيضمن أننا نحدِّث المشاركة ولا نضيف مشاركة جديدة. نقوم بذلك ببساطة عن طريق تغيير الوظيفة التي نستخدمها ، بدلاً من استخدام wp_insert_post ،سنستخدم wp_update_post . جعل كودنا النهائي على النحو التالي:

1
2
3	$post_id = wp_update_post( $post_information );

وهذا كل شيء من أجل تحرير البريد عبر الواجهة الأمامية. وأخيرًا ، بالنسبة إلى هذا الجزء من السلسلة الصغيرة ، سنتناول كيفية حذف المشاركات.

الخطوة 3 حذف مشاركاتنا

الآن هناك العديد من الطرق المختلفة لحذف المشاركات ، وكانت هناك العديد من المناقشات المختلفة في أفضل طريقة حول كيفية تحقيق ذلك ، من قبل بعض الناس ربما هذه هي الطريقة الغير الصحيحة ولكن أشعر أنها تعمل بشكل جيد لهذا الوضع الحالي. سنستخدمالدالة get_delete_post_link .

سنقوم بتمرير هذه الوظيفة إلى "حذف الارتباط" الخاص بنا ، مع تمرير معرف المشاركة ، على النحو التالي:

1
2
3	<a href="<?php echo get_delete_post_link( get_the_ID() ); ?>">/Delete</a>

ومن البسيط حذف المشاركات عبر الواجهة الأمامية. سنقوم بتوسيع ذلك قليلاً للتأكد من أننا لن نواجه أي أخطاء ونقدم إشعارًا بالمزيد من المستخدمين بأننا نقوم بحذف مشاركة. نقوم بذلك عن طريق إدخال وظيفة تأكيد بسيطة جدًا على onclick ، على النحو التالي:

1
2
3	<a onclick="return confirm('Are you sure you wish to delete post: <?php echo get_the_title() ?>?')" href="<?php echo get_delete_post_link( get_the_ID() ); ?>">Delete</a>

أخيرًا ، سنقوم بلف شرط حول رابط الحذف الخاص بنا ، للتأكد من أنه لا يمكننا حذف مشاركة إلا إذا كانت الحالة الحالية للمشاركة غير موجودة بالفعل في المهملات. نقوم بهذا على النحو التالي:



<?php if( !(get_post_status() == 'trash') ) : ?>

	<a onclick="return confirm('Are you sure you wish to delete post: <?php echo get_the_title() ?>?')"href="<?php echo get_delete_post_link( get_the_ID() ); ?>">Delete</a>

<?php endif; ?>

وهذا كل شيء! يمكنك إرسال مشاركاتك إلى المهملات. فقط في حال كنت مهتمًا بالطريقة البديلة حول كيفية حذف المشاركات ، سأشرحها باختصار شديد.

الطريقة بسيطة للغاية لتحرير المشاركات ، عن طريق تمرير معرف المشاركة إلى عنوان URL مع إضافة معلمة للحذف والتحقق مما إذا كانت قيمة هذه المعلمة صحيحة ، وإذا كانت صحيحة ، فمرر الدالة wp_trash_post إلى الارتباط. هذا بسيط للغاية وفعال للغاية ، ولكن بالنسبة لحالنا الحالي ، يعمل get_delete_post_link بشكل جيد للغاية.

استنتاج

هذا الجزء 2 كامل! يمكننا الآن إدراج المشاركات وتعديل وحذف المشاركات عبر الواجهة الأمامية. لقد قمنا بتغطية الكثير من المحتوى حتى الآن ، وفي الجزء التالي سنحفر قليلاً.

في الجزء التالي ، سنلقي نظرة على الحقول المخصصة والمزيد.

أود أن أقول شكراً جزيلاً لكم على قضاء الوقت في قراءة البرنامج التعليمي الخاص بي ، وآمل أن يكون ذلك قد ساعدني. لا تتردد في ترك التعليقات وسأبذل قصارى جهدي للمساعدة والإجابة عليها ، إن لم يكن يمكنك دائما الاتصال بي مباشرة من خلال موقع الويب الخاص بي: www.VinnySingh.co أو تويتر @ VinnySinghUK

ترقبوا الجزء الثالث!