توفر التعليقات التوضيحية معلومات إضافية حول أي جزء محدد من المستند. يمكننا ترميز المستندات بالملاحظات والمراجعات باستخدام التعليقات التوضيحية. يمكننا إضافة صور أو تعليقات أو ملاحظات أو أنواع أخرى من الملاحظات الخارجية إلى مستندات PDF كتعليقات توضيحية. في هذه المقالة ، سنتعلم كيفية إضافة تعليقات توضيحية إلى مستندات PDF باستخدام واجهة برمجة تطبيقات REST في PHP.
سيتم تناول الموضوعات التالية في هذه المقالة:
- تعليقات PDF التوضيحية REST API و PHP SDK
- علق على مستندات PDF باستخدام واجهة برمجة تطبيقات REST في PHP
- أضف تعليقًا توضيحيًا باستخدام التعليق التوضيحي للرابط باستخدام PHP
- أضف صورة توضيحية باستخدام PHP
- أضف تعليقًا توضيحيًا لحقل النص باستخدام PHP
شرح PDF التوضيحي REST API و PHP SDK
للتعليق على مستندات PDF ، سنستخدم PHP SDK of GroupDocs.Annotation Cloud API. يسمح بإضافة التعليقات التوضيحية وتراكبات العلامات المائية واستبدال النصوص والتنقيحات وعلامات النص إلى تنسيقات المستندات المدعومة. الرجاء تثبيته باستخدام الأمر التالي في وحدة التحكم:
composer require groupdocscloud/groupdocs-annotation-cloud
بعد التثبيت ، يرجى استخدام التحميل التلقائي للملحنين لاستخدام SDK كما هو موضح أدناه:
require_once('vendor/autoload.php');
يرجى الحصول على معرف العميل والسرية من لوحة التحكم قبل اتباع الخطوات المذكورة. بمجرد حصولك على المعرف والسر الخاص بك ، قم بإضافة الرمز كما هو موضح أدناه:
// يوضح مثال الرمز هذا كيفية إضافة معرف العميل والسرية في الكود.
static $ClientId = '659fe7da-715b-4744-a0f7-cf469a392b73';
static $ClientSecret = 'b377c36cfa28fa69960ebac6b6e36421';
static $ApiBaseUrl = 'https://api.groupdocs.cloud';
static $MyStorage = '';
// تهيئة التكوين
$configuration = new GroupDocs\Annotation\Configuration();
// ضبط التكوينات
$configuration->setAppSid(self::$ClientId);
$configuration->setAppKey(self::$ClientSecret);
$configuration->setApiBaseUrl(self::$ApiBaseUrl);
علق على مستندات PDF باستخدام واجهة برمجة تطبيقات REST في PHP
يمكننا إضافة تعليقات توضيحية إلى مستندات PDF على السحابة باتباع الخطوات البسيطة الواردة أدناه:
- تحميل ملف PDF على السحابة
- تعليق توضيحي على مستند PDF
- تنزيل الملف المشروح
قم بتحميل المستند
أولاً ، سنقوم بتحميل ملف PDF إلى السحابة باستخدام نموذج الكود التالي:
// يوضح مثال الرمز هذا كيفية تحميل ملف PDF إلى السحابة.
// تهيئة مثيل API
$apiInstance = new GroupDocs\Annotation\FileApi($configuration);
// مسار الملف
$file = "C:\\Files\\Annotation\\sample.pdf";
// طلب إنشاء ملف تحميل
$request = new GroupDocs\Annotation\Model\Requests\UploadFileRequest("sample.pdf", $file, self::$MyStorage, null);
// رفع ملف
$response = $apiInstance->uploadFile($request);
نتيجة لذلك ، سيكون ملف PDF الذي تم تحميله متاحًا في قسم الملفات من لوحة القيادة على السحابة.
علق مستند PDF باستخدام PHP
الآن ، سنضيف العديد من التعليقات التوضيحية إلى مستند PDF الذي تم تحميله برمجيًا باتباع الخطوات الواردة أدناه:
- أولاً ، قم بإنشاء مثيل لـ AnnotateApi.
- بعد ذلك ، قم بتعيين خصائص التعليق التوضيحي ، مثل الموضع والنوع والنص وما إلى ذلك.
- ثم كرر الخطوة أعلاه لإضافة عدة تعليقات توضيحية.
- بعد ذلك ، قم بتوفير مسار ملف الإدخال.
- بعد ذلك ، قم بتهيئة كائن AnnotateOptions وقم بتعيين مسار ملف الإخراج.
- بعد ذلك ، قم بإنشاء AnnotateRequest باستخدام AnnotateOptions كوسيطة.
- أخيرًا ، ضع تعليقًا توضيحيًا على ملف PDF باستخدام طريقة AnnotateApi.annotate().
يوضح نموذج التعليمات البرمجية التالي كيفية إضافة تعليقات توضيحية متعددة إلى مستند PDF باستخدام واجهة برمجة تطبيقات REST في PHP.
// يوضح مثال الكود هذا كيفية إضافة العديد من التعليقات التوضيحية إلى ملف PDF.
// تهيئة مثيل AnnotationAPI
$apiInstance = new GroupDocs\Annotation\علقApi($configuration);
// أضف تعليقًا توضيحيًا عن المسافة
$a = new GroupDocs\Annotation\Model\AnnotationInfo();
$pt = new GroupDocs\Annotation\Model\Point();
$pt->setX(1);
$pt->setY(1);
$a->setAnnotationPosition($pt);
$box = new GroupDocs\Annotation\Model\Rectangle();
$box->setX(100);
$box->setY(100);
$box->setWidth(200);
$box->setHeight(100);
$a->setBox($box);
$a->setPageNumber(0);
$a->setPenColor(1201033);
$a->setPenStyle(GroupDocs\Annotation\Model\AnnotationInfo::PEN_STYLE_SOLID);
$a->setPenWidth(1);
$a->setOpacity(0.7);
$a->setType(GroupDocs\Annotation\Model\AnnotationInfo::TYPE_DISTANCE);
$a->setText("This is distance annotation");
$a->setCreatorName("Anonym A.");
// أضف تعليقًا توضيحيًا للمنطقة
$a1 = new GroupDocs\Annotation\Model\AnnotationInfo();
$pt1 = new GroupDocs\Annotation\Model\Point();
$pt1->setX(1);
$pt1->setY(1);
$a1->setAnnotationPosition($pt1);
$box1 = new GroupDocs\Annotation\Model\Rectangle();
$box1->setX(80);
$box1->setY(400);
$box1->setWidth(200);
$box1->setHeight(100);
$a1->setBox($box1);
$a1->setPageNumber(0);
$a1->setPenColor(1201033);
$a1->setPenStyle(GroupDocs\Annotation\Model\AnnotationInfo::PEN_STYLE_SOLID);
$a1->setPenWidth(1);
$a1->setOpacity(0.7);
$a1->setType(GroupDocs\Annotation\Model\AnnotationInfo::TYPE_AREA);
$a1->setText("This is area annotation");
$a1->setCreatorName("Anonym A.");
// أضف تعليقًا توضيحيًا للنقطة
$a2 = new GroupDocs\Annotation\Model\AnnotationInfo();
$pt2 = new GroupDocs\Annotation\Model\Point();
$pt2->setX(100);
$pt2->setY(100);
$a2->setAnnotationPosition($pt2);
$box2 = new GroupDocs\Annotation\Model\Rectangle();
$box2->setX(450);
$box2->setY(150);
$box2->setWidth(100);
$box2->setHeight(30);
$a2->setBox($box2);
$a2->setPageNumber(0);
$a2->setOpacity(0.7);
$a2->setType(GroupDocs\Annotation\Model\AnnotationInfo::TYPE_POINT);
$a2->setText("This is point annotation");
$a2->setCreatorName("Anonym A.");
// أضف تعليقًا توضيحيًا على شكل سهم
$a3 = new GroupDocs\Annotation\Model\AnnotationInfo();
$pt3 = new GroupDocs\Annotation\Model\Point();
$pt3->setX(1);
$pt3->setY(1);
$a3->setAnnotationPosition($pt3);
$box3 = new GroupDocs\Annotation\Model\Rectangle();
$box3->setX(350);
$box3->setY(350);
$box3->setWidth(200);
$box3->setHeight(100);
$a3->setBox($box3);
$a3->setPageNumber(0);
$a3->setPenColor(1201033);
$a3->setPenStyle(GroupDocs\Annotation\Model\AnnotationInfo::PEN_STYLE_SOLID);
$a3->setPenWidth(1);
$a3->setOpacity(0.7);
$a3->setType(GroupDocs\Annotation\Model\AnnotationInfo::TYPE_ARROW);
$a3->setText("This is arrow annotation");
$a3->setCreatorName("Anonym A.");
// مسار ملف الإدخال
$fileInfo = new GroupDocs\Annotation\Model\FileInfo();
$fileInfo->setFilePath("sample.pdf");
// تحديد خيارات التعليق التوضيحي
$options = new GroupDocs\Annotation\Model\علقOptions();
$options->setFileInfo($fileInfo);
$options->setAnnotations([$a, $a1, $a2, $a3]);
$options->setOutputPath("MultipleAnnotation.pdf");
// إنشاء طلب تعليق توضيحي
$request = new GroupDocs\Annotation\Model\Requests\annotateRequest($options);
// علق
$result = $apiInstance->annotate($request);
echo "AddMultipleAnnotations: Multiple Annotations added: " . $result->getHref();
علق مستند PDF باستخدام PHP.
يمكنك قراءة المزيد حول أنواع التعليقات التوضيحية المدعومة ضمن قسم إضافة التعليقات التوضيحية في الوثائق.
قم بتنزيل الملف المشروح
سيحفظ نموذج الكود أعلاه ملف PDF المشروح على السحابة. يمكن تنزيله باستخدام نموذج التعليمات البرمجية التالي:
// يوضح مثال الرمز هذا كيفية تنزيل ملف PDF من السحابة.
// تهيئة مثيل API
$apiInstance = new GroupDocs\Annotation\FileApi($configuration);
// طلب إنشاء ملف تنزيل
$request = new GroupDocs\Annotation\Model\Requests\DownloadFileRequest("MultipleAnnotation.pdf", self::$MyStorage, null);
// تحميل الملف
$response = $apiInstance->downloadFile($request);
أضف تعليقًا توضيحيًا باستخدام التعليق التوضيحي للرابط باستخدام PHP
يمكننا أيضًا إضافة تعليق توضيحي للارتباط التشعبي في مستند PDF باتباع الخطوات الواردة أدناه:
- أولاً ، قم بإنشاء مثيل لـ AnnotateApi.
- بعد ذلك ، قم بتعيين خصائص التعليق التوضيحي ، مثل الموضع والنص وما إلى ذلك.
- بعد ذلك ، قم بتعيين نوع التعليق التوضيحي على أنه ارتباط.
- بعد ذلك ، قم بتوفير مسار ملف الإدخال.
- بعد ذلك ، قم بتهيئة كائن AnnotateOptions وقم بتعيين مسار ملف الإخراج.
- بعد ذلك ، قم بإنشاء AnnotateRequest باستخدام AnnotateOptions كوسيطة.
- أخيرًا ، ضع تعليقًا توضيحيًا على ملف PDF باستخدام طريقة AnnotateApi.annotate().
يوضح نموذج التعليمات البرمجية التالي كيفية إضافة تعليق توضيحي للارتباط التشعبي في مستند PDF باستخدام واجهة برمجة تطبيقات REST. يرجى اتباع الخطوات المذكورة سابقاً لتحميل وتنزيل ملف.
// يوضح مثال الكود هذا كيفية إضافة تعليق توضيحي للرابط إلى PDF
// تهيئة مثيل AnnotationAPI
$apiInstance = new GroupDocs\Annotation\علقApi($configuration);
// أضف تعليقًا توضيحيًا للرابط
$a = new GroupDocs\Annotation\Model\AnnotationInfo();
$pt1 = new GroupDocs\Annotation\Model\Point();
$pt1->setX(80);
$pt1->setY(710);
$pt2 = new GroupDocs\Annotation\Model\Point();
$pt2->setX(240);
$pt2->setY(710);
$pt3 = new GroupDocs\Annotation\Model\Point();
$pt3->setX(80);
$pt3->setY(650);
$pt4 = new GroupDocs\Annotation\Model\Point();
$pt4->setX(240);
$pt4->setY(650);
$a->setPoints([$pt1, $pt2, $pt3, $pt4]);
$a->setUrl("https://www.groupdocs.com/");
$a->setPageNumber(0);
$a->setFontColor(1201033);
$a->setType(GroupDocs\Annotation\Model\AnnotationInfo::TYPE_LINK);
$a->setText("This is link annotation");
$a->setCreatorName("Anonym A.");
// مسار ملف الإدخال
$fileInfo = new GroupDocs\Annotation\Model\FileInfo();
$fileInfo->setFilePath("sample.pdf");
// تحديد خيارات التعليق التوضيحي
$options = new GroupDocs\Annotation\Model\علقOptions();
$options->setFileInfo($fileInfo);
$options->setAnnotations([$a]);
$options->setOutputPath("AddLinkAnnotation.pdf");
// إنشاء طلب تعليق توضيحي
$request = new GroupDocs\Annotation\Model\Requests\annotateRequest($options);
// علق
$result = $apiInstance->annotate($request);
echo "AddLinkAnnotation: Link Annotation added: " . $result->getHref();
علق باستخدام التعليقات التوضيحية للرابط باستخدام PHP.
أضف تعليقًا للصورة باستخدام PHP
يمكننا إضافة تعليق توضيحي للصورة في مستند PDF باتباع الخطوات المذكورة سابقًا. ومع ذلك ، نحتاج فقط إلى تعيين نوع التعليق التوضيحي على الصورة كما هو موضح أدناه:
$a->setType(GroupDocs\Annotation\Model\AnnotationInfo::TYPE_IMAGE);
يوضح نموذج التعليمات البرمجية التالي كيفية إضافة تعليق توضيحي للصورة في مستند PDF باستخدام واجهة برمجة تطبيقات REST في PHP. يرجى اتباع الخطوات المذكورة سابقاً لتحميل وتنزيل ملف.
// يوضح مثال الكود هذا كيفية إضافة تعليق توضيحي للصورة إلى ملف PDF
// تهيئة مثيل AnnotationAPI
$apiInstance = new GroupDocs\Annotation\علقApi($configuration);
// أضف تعليقًا على الصورة
$a = new GroupDocs\Annotation\Model\AnnotationInfo();
$pt = new GroupDocs\Annotation\Model\Point();
$pt->setX(1);
$pt->setY(1);
$a->setAnnotationPosition($pt);
$box = new GroupDocs\Annotation\Model\Rectangle();
$box->setX(200);
$box->setY(0);
$box->setWidth(200);
$box->setHeight(100);
$a->setBox($box);
$a->setPageNumber(0);
$a->setImagePath("groupdocs.png");
$a->setPenStyle(GroupDocs\Annotation\Model\AnnotationInfo::PEN_STYLE_SOLID);
$a->setOpacity(0.7);
$a->setType(GroupDocs\Annotation\Model\AnnotationInfo::TYPE_IMAGE);
$a->setText("This is image annotation");
$a->setCreatorName("Anonym A.");
// مسار ملف الإدخال
$fileInfo = new GroupDocs\Annotation\Model\FileInfo();
$fileInfo->setFilePath("sample.pdf");
// تحديد خيارات التعليق التوضيحي
$options = new GroupDocs\Annotation\Model\علقOptions();
$options->setFileInfo($fileInfo);
$options->setAnnotations([$a]);
$options->setOutputPath("AddImageAnnotation.pdf");
// إنشاء طلب تعليق توضيحي
$request = new GroupDocs\Annotation\Model\Requests\annotateRequest($options);
// علق
$result = $apiInstance->annotate($request);
echo "AddImageAnnotation: Image Annotation added: " . $result->getHref();
أضف تعليقًا للصورة باستخدام PHP.
أضف تعليقًا توضيحيًا لحقل النص باستخدام PHP
يمكننا أيضًا إضافة تعليق توضيحي للحقل النصي في مستند PDF باتباع الخطوات المذكورة سابقًا. ومع ذلك ، نحتاج فقط إلى تعيين نوع التعليق التوضيحي على حقل النص كما هو موضح أدناه:
$a->setType(GroupDocs\Annotation\Model\AnnotationInfo::TYPE_TEXT_FIELD);
يوضح نموذج التعليمات البرمجية التالي كيفية إضافة تعليق توضيحي لحقل نصي في مستند PDF باستخدام واجهة برمجة تطبيقات REST. يرجى اتباع الخطوات المذكورة سابقاً لتحميل وتنزيل ملف.
// يوضح مثال الكود هذا كيفية إضافة تعليق توضيحي لحقل نصي إلى PDF
// تهيئة مثيل AnnotationAPI
$apiInstance = new GroupDocs\Annotation\علقApi($configuration);
// أضف تعليقًا توضيحيًا في حقل النص
$a = new GroupDocs\Annotation\Model\AnnotationInfo();
$pt = new GroupDocs\Annotation\Model\Point();
$pt->setX(1);
$pt->setY(1);
$a->setAnnotationPosition($pt);
$box = new GroupDocs\Annotation\Model\Rectangle();
$box->setX(380);
$box->setY(300);
$box->setWidth(100);
$box->setHeight(50);
$a->setBox($box);
$a->setPageNumber(0);
$a->setFontColor(1201033);
$a->setFontSize(12);
$a->setOpacity(0.7);
$a->setType(GroupDocs\Annotation\Model\AnnotationInfo::TYPE_TEXT_FIELD);
$a->setText("Text field text");
$a->setCreatorName("Anonym A.");
// مسار ملف الإدخال
$fileInfo = new GroupDocs\Annotation\Model\FileInfo();
$fileInfo->setFilePath("sample.pdf");
// تحديد خيارات التعليق التوضيحي
$options = new GroupDocs\Annotation\Model\علقOptions();
$options->setFileInfo($fileInfo);
$options->setAnnotations([$a]);
$options->setOutputPath("AddTextFieldAnnotation.pdf");
// إنشاء طلب تعليق توضيحي
$request = new GroupDocs\Annotation\Model\Requests\annotateRequest($options);
// علق
$result = $apiInstance->annotate($request);
echo "AddTextFieldAnnotation: Text Field Annotation added: " . $result->getHref();
أضف تعليقًا توضيحيًا لحقل النص باستخدام PHP.
جرب عبر الإنترنت
يرجى تجربة أداة التعليقات التوضيحية التالية بصيغة PDF المجانية عبر الإنترنت ، والتي تم تطويرها باستخدام واجهة برمجة التطبيقات المذكورة أعلاه. https://products.groupdocs.app/annotation/pdf
خاتمة
في هذه المقالة ، تعلمنا كيفية:
- إضافة العديد من التعليقات التوضيحية إلى ملف PDF باستخدام PHP ؛
- إضافة تعليق توضيحي لملف PDF مع رابط وصورة وتعليق توضيحي للحقل النصي في PHP ؛
- تحميل ملف PDF برمجيًا إلى السحابة ؛
- قم بتنزيل ملف PDF المشروح من السحابة.
بالإضافة إلى ذلك ، يمكنك معرفة المزيد حول GroupDocs.Annotation Cloud API باستخدام التوثيق. نوفر أيضًا قسم مرجع واجهة برمجة التطبيقات الذي يتيح لك تصور واجهات برمجة التطبيقات الخاصة بنا والتفاعل معها مباشرةً من خلال المتصفح. في حالة وجود أي غموض ، لا تتردد في الاتصال بنا على المنتدى.