إدارة روابط العرض التقديمي في PHP
مقدمة
يُربط الارتباط التشعبي محتوى العرض بموقع ويب أو موقع داخل العرض. في PowerPoint، يُستخدم الارتباطات التشعبية عادةً لغرضين:
- فتح موقع ويب من نص أو شكل أو إطار وسائط.
- التنقل إلى شريحة أخرى، على سبيل المثال من جدول المحتويات.
يسمح Aspose.Slides for PHP عبر Java لك بإضافة هذه الروابط، التحكم في مظهرها وصوتها، تحديث خصائصها، وإزالتها. تُظهر الأمثلة أدناه كيفية العمل مع الروابط التشعبية على العناصر الفردية وكيفية الوصول إلى الروابط على مستوى العرض أو الشريحة أو إطار النص. تفترض أن جسر PHP/Java وملف التفاف Aspose.Slides PHP مُinitialized. الأعضاء في API الذين لا يمتلكون صفحة مرجعية PHP يربطون إلى API Java الأساسي.
Note
يمكنك أيضًا تعديل العروض باستخدام محرر Aspose PowerPoint المجاني عبر الإنترنت.إضافة روابط URL
يمكنك تعيين عنوان URL لموقع ويب إلى نص أو شكل أو إطار وسائط. العنصر الذي تُعيّن إليه الارتباط التشعبي يحدّد منطقة النقر: جزء النص يربط النص المحدد، بينما الشكل أو الإطار يربط كائن الشريحة.
لعروض تحتوي على روابط تشعبية نسبية، راجع Manage the Hyperlink Base لقراءة أو تغيير أو مسح القاعدة على مستوى المستند.
إضافة روابط URL إلى النص
لربط نص بموقع ويب، مرّر كائن Hyperlink إلى طريقة setHyperlinkClick لجزء النص، كما هو موضح أدناه. فقط ذلك الجزء من النص يصبح قابلاً للنقر.
use aspose\slides\Hyperlink;
use aspose\slides\Presentation;
use aspose\slides\SaveFormat;
use aspose\slides\ShapeType;
$presentation = new Presentation();
try {
$textShape = $presentation->getSlides()->get_Item(0)->getShapes()->addAutoShape(ShapeType::Rectangle, 100, 100, 600, 50, false);
$textShape->addTextFrame("Aspose: File Format APIs");
$portionFormat = $textShape->getTextFrame()->getParagraphs()->get_Item(0)->getPortions()->get_Item(0)->getPortionFormat();
$portionFormat->setHyperlinkClick(new Hyperlink("https://www.aspose.com/"));
$portionFormat->getHyperlinkClick()->setTooltip("Explore Aspose file format APIs");
$portionFormat->setFontHeight(32);
$presentation->save("presentation-out.pptx", SaveFormat::Pptx);
} finally {
$presentation->dispose();
}
إضافة روابط URL إلى الأشكال وإطارات الوسائط
استدعِ setHyperlinkClick على المستطيل لجعل كامل مساحته قابلة للنقر. استخدم setTooltip لعرض تلميح للقراء حول الوجهة عندما يمرّرون المؤشر فوق المستطيل. كلا الطريقتين تنطبقان أيضًا على إطارات الصور والصوت والفيديو.
use aspose\slides\Hyperlink;
use aspose\slides\Presentation;
use aspose\slides\SaveFormat;
use aspose\slides\ShapeType;
$presentation = new Presentation();
try {
$shape = $presentation->getSlides()->get_Item(0)->getShapes()->addAutoShape(ShapeType::Rectangle, 100, 100, 600, 50);
$shape->setHyperlinkClick(new Hyperlink("https://www.aspose.com/"));
$shape->getHyperlinkClick()->setTooltip("Explore Aspose file format APIs");
$presentation->save("presentation-out.pptx", SaveFormat::Pptx);
} finally {
$presentation->dispose();
}
استخدام الروابط لإنشاء جدول محتويات
تتيح الروابط الداخلية للقارئ القفز من جدول المحتويات إلى شريحة محددة. المثال التالي يستخدم setInternalHyperlinkClick لربط نص “Page 2” في الشريحة الأولى إلى الشريحة الثانية.
use aspose\slides\FillType;
use aspose\slides\Paragraph;
use aspose\slides\Portion;
use aspose\slides\Presentation;
use aspose\slides\SaveFormat;
use aspose\slides\ShapeType;
$presentation = new Presentation();
try {
$firstSlide = $presentation->getSlides()->get_Item(0);
$secondSlide = $presentation->getSlides()->addEmptySlide($firstSlide->getLayoutSlide());
$tableOfContents = $firstSlide->getShapes()->addAutoShape(ShapeType::Rectangle, 40, 40, 300, 100);
$tableOfContents->getFillFormat()->setFillType(FillType::NoFill);
$tableOfContents->getLineFormat()->getFillFormat()->setFillType(FillType::NoFill);
$tableOfContents->getTextFrame()->getParagraphs()->clear();
$paragraph = new Paragraph();
$paragraph->getParagraphFormat()->getDefaultPortionFormat()->getFillFormat()->setFillType(FillType::Solid);
$paragraph->getParagraphFormat()->getDefaultPortionFormat()->getFillFormat()->getSolidFillColor()->setColor(java("java.awt.Color")->BLACK);
$paragraph->setText("Title of slide 2 .......... ");
$linkPortion = new Portion();
$linkPortion->setText("Page 2");
$linkPortion->getPortionFormat()->getHyperlinkManager()->setInternalHyperlinkClick($secondSlide);
$paragraph->getPortions()->add($linkPortion);
$tableOfContents->getTextFrame()->getParagraphs()->add($paragraph);
$presentation->save("link_to_slide.pptx", SaveFormat::Pptx);
} finally {
$presentation->dispose();
}
تنسيق الروابط
يمكنك تغيير لون النص المرتبط، تشغيل أو إيقاف صوت عندما ينشط القارئ الرابط، وتعيين التلميح الذي يظهر عند المرور.
اللون
طريقة setColorSource لكائن Hyperlink تحدد ما إذا كان الارتباط يستخدم لون الارتباط في العرض أو تنسيق جزء النص. لتطبيق لون نص مخصص، اختر HyperlinkColorSource::PortionFormat واضبط لون تعبئة الجزء. تم تقديم هذه الميزة في PowerPoint 2019؛ الإصدارات القديمة لا تطبق هذا الإعداد.
في هذا المثال، تجعل setColorSource الرابط الأول يستخدم تعبئة حمراء لجزء النص. الرابط الثاني يبقي على لون الارتباط في العرض.
use aspose\slides\FillType;
use aspose\slides\Hyperlink;
use aspose\slides\HyperlinkColorSource;
use aspose\slides\Presentation;
use aspose\slides\SaveFormat;
use aspose\slides\ShapeType;
$presentation = new Presentation();
try {
$coloredShape = $presentation->getSlides()->get_Item(0)->getShapes()->addAutoShape(ShapeType::Rectangle, 100, 100, 450, 50, false);
$coloredShape->addTextFrame("This hyperlink uses a custom color.");
$coloredPortionFormat = $coloredShape->getTextFrame()->getParagraphs()->get_Item(0)->getPortions()->get_Item(0)->getPortionFormat();
$coloredPortionFormat->setHyperlinkClick(new Hyperlink("https://www.aspose.com/"));
$coloredPortionFormat->getHyperlinkClick()->setColorSource(HyperlinkColorSource::PortionFormat);
$coloredPortionFormat->getFillFormat()->setFillType(FillType::Solid);
$coloredPortionFormat->getFillFormat()->getSolidFillColor()->setColor(java("java.awt.Color")->RED);
$defaultShape = $presentation->getSlides()->get_Item(0)->getShapes()->addAutoShape(ShapeType::Rectangle, 100, 200, 450, 50, false);
$defaultShape->addTextFrame("This hyperlink uses the default color.");
$defaultShape->getTextFrame()->getParagraphs()->get_Item(0)->getPortions()->get_Item(0)->getPortionFormat()->setHyperlinkClick(new Hyperlink("https://www.aspose.com/"));
$presentation->save("presentation-out-hyperlink.pptx", SaveFormat::Pptx);
} finally {
$presentation->dispose();
}
الصوت
يمكن للارتباط التشعبي تشغيل صوت عند تنشيطه أو إيقاف صوت يُشغل بالفعل. استخدم الطرق التالية لتكوين هذه السلوكيات:
- Hyperlink::setSound يحدد ملف الصوت المرتبط بالارتباط.
- Hyperlink::setStopSoundOnClick يتحكم فيما إذا كان تنشيط الارتباط يوقف الصوت السابق.
إضافة صوت للارتباط التشعبي
الزر في الشريحة الأولى يستخدم Hyperlink::setSound لتشغيل الصوت من sampleaudio.wav عندما ينقر القارئ للتقدم. في الشريحة الثانية، زر منفصل يستخدم Hyperlink::setStopSoundOnClick لإيقاف التشغيل وإبقاء القارئ على تلك الشريحة.
use aspose\slides\Hyperlink;
use aspose\slides\Presentation;
use aspose\slides\SaveFormat;
use aspose\slides\ShapeType;
$presentation = new Presentation();
try {
$audioFile = new Java("java.io.File", "sampleaudio.wav");
$audioPath = $audioFile->toPath();
$audioData = java("java.nio.file.Files")->readAllBytes($audioPath);
$hyperlinkSound = $presentation->getAudios()->addAudio($audioData);
$firstSlide = $presentation->getSlides()->get_Item(0);
$playButton = $firstSlide->getShapes()->addAutoShape(ShapeType::SoundButton, 100, 100, 100, 50);
$playButton->setHyperlinkClick(Hyperlink::getNextSlide());
if (!java_values($playButton->getHyperlinkClick()->getStopSoundOnClick()) && java_is_null($playButton->getHyperlinkClick()->getSound()))
{
$playButton->getHyperlinkClick()->setSound($hyperlinkSound);
}
$secondSlide = $presentation->getSlides()->addEmptySlide($firstSlide->getLayoutSlide());
$stopButton = $secondSlide->getShapes()->addAutoShape(ShapeType::Rectangle, 100, 100, 100, 50);
$stopButton->setHyperlinkClick(Hyperlink::getNoAction());
$stopButton->getHyperlinkClick()->setStopSoundOnClick(true);
$presentation->save("hyperlink-sound.pptx", SaveFormat::Pptx);
} catch (JavaException $exception) {
echo "Unable to read the audio file: " . $exception->getMessage() . PHP_EOL;
} finally {
$presentation->dispose();
}
استخراج صوت الارتباط التشعبي
المثال التالي يفتح العرض الذي تم إنشاؤه أعلاه ويقرأ صوت الارتباط للتشكل الأول إلى الذاكرة عبر getSound وgetBinaryData.
use aspose\slides\Presentation;
$presentation = new Presentation("hyperlink-sound.pptx");
try {
if (java_values($presentation->getSlides()->size()) > 0 && java_values($presentation->getSlides()->get_Item(0)->getShapes()->size()) > 0) {
$hyperlink = $presentation->getSlides()->get_Item(0)->getShapes()->get_Item(0)->getHyperlinkClick();
$sound = java_is_null($hyperlink) ? null : $hyperlink->getSound();
if (!java_is_null($sound)) {
$audioData = $sound->getBinaryData();
echo "Extracted " . strlen(java_values($audioData)) . " bytes of hyperlink audio." . PHP_EOL;
} else {
echo "The first shape has no hyperlink sound." . PHP_EOL;
}
} else {
echo "The presentation has no first slide or shape to inspect." . PHP_EOL;
}
} finally {
$presentation->dispose();
}
إعدادات التلميحات والتفاعل
يمكنك استدعاء طرق Hyperlink التالية بعد تعيين ارتباط تشعبي إلى نص أو شكل:
- setTooltip يحدد النص الذي يمكن للمشاهد عرضه كتلميح للربط.
- setTargetFrame يحدد إطار الهدف داخل مجموعة إطارات HTML أصلية، إذا كان ذلك مناسبًا.
- setHistory يتحكم فيما إذا كان تنشيط الرابط يضيف وجهته إلى قائمة الروابط التي تم عرضها.
- setHighlightClick يتحكم فيما إذا كان يتم تمييز الارتباط عند النقر.
إزالة الروابط من العروض
استخدم getAnyHyperlinks لجمع حاويات الروابط، بما في ذلك روابط أجزاء النص، قبل تعديلها. المثال التالي يزيل كلا نوعي التنشيط من الشريحة الأولى. لإزالة نوع واحد فقط، استدعِ فقط removeHyperlinkClick أو removeHyperlinkMouseOver؛ إزالة إجراء النقر لا يزيل نظيره عند المرور فوقه.
use aspose\slides\Presentation;
use aspose\slides\SaveFormat;
$presentation = new Presentation("pres.pptx");
try {
if (java_values($presentation->getSlides()->size()) > 0) {
$containers = [];
foreach ($presentation->getSlides()->get_Item(0)->getHyperlinkQueries()->getAnyHyperlinks() as $container) {
$containers[] = $container;
}
foreach ($containers as $container) {
$container->getHyperlinkManager()->removeHyperlinkClick();
$container->getHyperlinkManager()->removeHyperlinkMouseOver();
}
$presentation->save("pres-removed-hyperlinks.pptx", SaveFormat::Pptx);
} else {
echo "The presentation has no slides to process." . PHP_EOL;
}
} finally {
$presentation->dispose();
}
لإزالة غير مشروطة، removeAllHyperlinks يزيل كلا نوعي التنشيط في النطاق المحدد بندية واحدة. للتنظيف الانتقائي وتغطية الماسترز والتخطيطات والملاحظات، انظر الإبلاغ، التطهير، والتحقق من الروابط.
مسح الروابط قبل استبدال نص SmartArt
عند استبدال فقرة في عقدة SmartArt موجودة، قد يترك مسح أجزاء النص رابطًا قديمًا فعالًا. استرجع الفقرة عبر SmartArtNode::getTextFrame. قبل مسح أجزائه، استدعِ getHyperlinkQueries على إطار النص لشكل العقدة الذي يعرض الفقرة، ثم استدعِ removeAllHyperlinks على الكائن المرجع. ذلك يزيل كل ارتباط في ذلك الإطار، بما في ذلك الروابط في فقراته الأخرى.
يفترض المثال أن الشكل الثالث في الشريحة الأولى من SmartArtHyperlink.pptx هو رسم SmartArt. يستبدل الفقرة الأولى من العقدة الرابعة. في هذا العرض، الشكل الأول للعقدة يعرض تلك الفقرة.
بعد إضافة الجزئين، يقرأ المثال تنسيقهما الفعال باستخدام getEffective. على ذلك التنسيق، تُعيد getHyperlinkClick الارتباط الجديد للجزء الأول وnull للثاني.
use aspose\slides\Hyperlink;
use aspose\slides\Portion;
use aspose\slides\Presentation;
$presentation = new Presentation("SmartArtHyperlink.pptx");
try {
$slide = $presentation->getSlides()->get_Item(0);
$smartArt = $slide->getShapes()->get_Item(2);
$node = $smartArt->getAllNodes()->get_Item(3);
$paragraph = $node->getTextFrame()->getParagraphs()->get_Item(0);
$node->getShapes()->get_Item(0)->getTextFrame()->getHyperlinkQueries()->removeAllHyperlinks();
$paragraph->getPortions()->clear();
$link = new Portion("New reference");
$link->getPortionFormat()->setHyperlinkClick(new Hyperlink("https://example.com/new"));
$paragraph->getPortions()->add($link);
$text = new Portion(" (updated)");
$paragraph->getPortions()->add($text);
echo java_values($link->getPortionFormat()->getEffective()->getHyperlinkClick()->getExternalUrl()), PHP_EOL; // https://example.com/new
var_dump(java_is_null($text->getPortionFormat()->getEffective()->getHyperlinkClick())); // bool(true): الجزء الثاني لا يحتوي على ارتباط تشعبي.
} finally {
$presentation->dispose();
}
إنشاء جرد كامل للروابط
قبل توزيع عرض، قم بجرد الإجراءات التفاعلية وكذلك روابط الويب. تُعيد getAnyHyperlinks كائنات IHyperlinkContainer، وليس قائمة مسطحة من سلاسل URL. افحص كل من getHyperlinkClick وgetHyperlinkMouseOver لكل حاوية. هما مستقلان: يمكن لنفس الحاوية أن تكشف عن كلا الإجراءين، لذا يحتاج التقرير الكامل إلى صفين كحد أقصى لكل حاوية.
فحص الروابط على مستوى الشكل فقط قد يفوت الروابط المرفقة بأجزاء النص. استعلم النطاق المناسب بدلًا من ذلك، واحتفظ بالحاويات المرجعة لتتمكن لاحقًا من تحديث أو إزالة إجراءاتها.
استعلام نطاقات العرض والشريحة وإطار النص
فئة HyperlinkQueries متاحة عبر Presentation::getHyperlinkQueries، IBaseSlide::getHyperlinkQueries، وTextFrame::getHyperlinkQueries. كل نطاق يدعم الاستعلامات نفسها:
- getHyperlinkClicks تُعيد الحاويات التي لها إجراء نقر.
- getHyperlinkMouseOvers تُعيد الحاويات التي لها إجراء مرور فوق.
- getAnyHyperlinks تُعيد الحاويات التي لها أي من الإجراءين أو كليهما.
هذا المثال يعيّن إجراءات نقر ومرور فوق إلى شكل ونصه، وإجراء ماكرو إلى زر منفصل. يقارن عدد الحاويات التي تُعيدها getAnyHyperlinks مع الأعداد لكل نوع من أنواع التنشيط. استعلام إطار النص يُحصي الروابط داخل النص فقط. تظهر إجراءات الشكل المحيطة في استعلامات الشريحة والعرض.
use aspose\slides\Presentation;
use aspose\slides\SaveFormat;
use aspose\slides\ShapeType;
function printQueryCounts($scope, $queries) {
$clickCount = java_values($queries->getHyperlinkClicks()->size());
$mouseOverCount = java_values($queries->getHyperlinkMouseOvers()->size());
$anyCount = java_values($queries->getAnyHyperlinks()->size());
echo "$scope: click=$clickCount, mouse-over=$mouseOverCount, any=$anyCount" . PHP_EOL;
}
$presentation = new Presentation();
try {
$slide = $presentation->getSlides()->get_Item(0);
$destination = $presentation->getSlides()->addEmptySlide($slide->getLayoutSlide());
$shape = $slide->getShapes()->addAutoShape(ShapeType::Rectangle, 20, 20, 400, 60);
$shape->getTextFrame()->setText("Click the text to go to slide 2");
$shape->getHyperlinkManager()->setExternalHyperlinkClick("https://example.com/");
$shape->getHyperlinkClick()->setTooltip("Public website");
$shape->getHyperlinkManager()->setExternalHyperlinkMouseOver("file:///C:/private/report.xlsx");
$portionFormat = $shape->getTextFrame()->getParagraphs()->get_Item(0)->getPortions()->get_Item(0)->getPortionFormat();
$portionFormat->getHyperlinkManager()->setInternalHyperlinkClick($destination);
$portionFormat->getHyperlinkManager()->setExternalHyperlinkMouseOver("https://example.com/help");
$macroButton = $slide->getShapes()->addAutoShape(ShapeType::Rectangle, 20, 120, 200, 60);
$macroButton->getHyperlinkManager()->setMacroHyperlinkClick("ReviewPresentation");
printQueryCounts("Presentation", $presentation->getHyperlinkQueries());
printQueryCounts("Slide 1", $slide->getHyperlinkQueries());
printQueryCounts("Text frame", $shape->getTextFrame()->getHyperlinkQueries());
$presentation->save("hyperlink-audit-input.pptx", SaveFormat::Pptx);
} finally {
$presentation->dispose();
}
في هذا المثال، يُظهر استعلام العرض والشريحة كل منهما ثلاثة حاويات نقر، حاويتين مرور فوق، وثلاث حاويات أي إجراء. يُظهر استعلام إطار النص حاوية واحدة في كل فئة.
تصنيف الإجراءات والوجهات
استخدم Hyperlink::getActionType لتفسير الإجراء قبل تفسير وجهته. قيم HyperlinkActionType تغطي أكثر من تنقل الويب:
| Values | Meaning for an audit |
|---|---|
Hyperlink |
ارتباط خارجي؛ افحص عنوان URL ومخططه. |
JumpSpecificSlide |
تنقل داخلي إلى شريحة معينة. |
JumpFirstSlide, JumpPreviousSlide, JumpNextSlide, JumpLastSlide, JumpLastViewedSlide |
تنقل مدمج في عرض الشرائح، يُحل في سياق عرض الشرائح. |
JumpEndShow, StartCustomSlideShow |
إنهاء العرض الحالي أو بدء عرض مخصص. |
StartMacro |
تنفيذ ماكرو. |
StartProgram |
تشغيل برنامج. |
OpenFile, OpenPresentation |
فتح ملف أو عرض آخر؛ راجع منفصلًا عن عناوين URL للويب. |
StartStopMedia |
بدء أو إيقاف تشغيل وسائط. |
NoAction, Unknown |
لا يوجد إجراء تنقل، أو إجراء غير معروف يتطلب مراجعة. |
اقرأ الوجهات الخارجية من خلال getExternalUrl والوجهات الداخلية المحددة من خلال getTargetSlide. قد لا تحتوي الإجراءات الداخلية والأوامر المدمجة على URL خارجي؛ URL فارغ لا يعني أن الحاوية لا تمتلك إجراءً. احفظ القيمة التي تُعيدها getExternalUrlOriginal عندما تختلف عن URL المُطبع، وضمن التلميح الذي تُعيده getTooltip إذا كان متوفرًا.
الإبلاغ، التطهير، والتحقق من الروابط
يفتح هذا المثال العرض من المثال السابق ويسجل سجل JSON واحد لكل إجراء. يستخدم getAnyHyperlinks لجمع الحاويات على الشرائح العادية، الماسترز، التخطيطات، والملاحظات، بما في ذلك ماستر الملاحظات والنسخ عند وجودها. يستخدم المساواة المرجعية لحساب كل حاوية مرة واحدة، يطبّق السياسة الموضحة أدناه، ثم يعيد فتح العرض المحفوظ للتحقق من كل من إجراءات النقر والمرور فوق.
يسجل التقرير فهرس شريحة يبدأ من الواحد وgetSlideId حيثما كان متوفرًا. توفر ISlideComponent::getSlide الشريحة المالكة للحاويات المدعومة. لا تملك الماسترز، التخطيطات، والملاحظات فهرس شريحة عادي وتُحدد بنطاقها. يتم تسمية حاويات الشكل وحاويات تنسيق جزء النص بشكل منفصل؛ الأنواع الأخرى تحتفظ باسم نوعها في وقت التشغيل. تحصل كل حاوية على معرف محلي في التقرير لربط إجراءيها. يخزن التقرير أنواع الإجراءات كقواعد عددية معرفة في تعداد PHP.
هذه السياسة المتحفظة تسمح فقط بعناوين HTTPS المطلقة وروابط شريحة داخلية صالحة. ترفض الماكرو، البرامج، إجراءات الملفات، إجراءات عرض الشرائح الأخرى، الإجراءات غير المعروفة، ومخططات URL أخرى. هذه الرفض قرارات سياسة، لا حكم أمان من Aspose.Slides. HTTPS وحده لا يضمن الثقة: أضف قوائم السماح للمضيف وفحوصات أخرى لتطبيقك. يتم فحص كل من URL الأصلي والـ URL المُطبع. يراجع المثال بيانات التعريف دون تتبع الروابط أو تشغيل الإجراءات.
للتصحيح، يدعم getHyperlinkManager الحاوية setExternalHyperlinkClick، removeHyperlinkClick، وremoveHyperlinkMouseOver. هنا، تُستبدل الروابط الخارجية غير المسموح بها بصفحة هبوط HTTPS ثابتة؛ تُزال الروابط غير المسموح بها للنقر والمرور فوق بشكل مستقل. اضبط $replaceExternalClicks إلى false لإزالة جميع مخالفات السياسة بدلًا من ذلك. اختر صفحة استبدال مملوكة للتطبيق قبل النشر.
علامة تصدير التقرير تستخدم سياسة مراجعة PDF متحفظة: تُعلِّم إجراءات المرور فوق وأي شيء غير ارتباط خارجي أو قفزة شريحة محددة على أنه قد لا يكون مدعومًا. إنها تلميح مراجعة، ليست اختبار قدرة أو ضمان بقاء الروابط غير الموسومة أثناء التصدير. قد تحافظ تصديرات PDF وHTML المدعومة على الروابط وفقًا للإجراء، خيارات التصدير، والمشاهد. لا يمكن لإطارات images وvideo الحفاظ على الروابط التفاعلية؛ علّم كل إجراء عند التدقيق لتلك المخرجات.
use aspose\slides\HyperlinkActionType;
use aspose\slides\Presentation;
use aspose\slides\SaveFormat;
class HyperlinkAudit {
public function slideIndex($presentation, $slide) {
if (java_is_null($slide)) return null;
for ($index = 0; $index < java_values($presentation->getSlides()->size()); $index++) {
if (java_values($presentation->getSlides()->get_Item($index)->equals($slide))) return $index + 1;
}
return null;
}
public function isHttps($value) {
if ($value === null || $value === '') return false;
$parts = parse_url($value);
return $parts !== false && isset($parts['scheme'], $parts['host']) && strcasecmp($parts['scheme'], 'https') === 0 && $parts['host'] !== '';
}
public function policyViolation($link) {
if (java_is_null($link)) return null;
$action = java_values($link->getActionType());
if ($action === HyperlinkActionType::JumpSpecificSlide) {
return java_is_null($link->getTargetSlide()) ? 'Missing target slide' : null;
}
if ($action !== HyperlinkActionType::Hyperlink) return 'Action is not allowed';
if (!$this->isHttps(java_values($link->getExternalUrl()))) return 'Normalized URL is not absolute HTTPS';
$original = java_values($link->getExternalUrlOriginal());
if ($original !== null && $original !== '' && !$this->isHttps($original)) return 'Original URL is not absolute HTTPS';
return null;
}
public function addScope(&$found, $slide) {
if (!java_is_null($slide)) {
foreach ($slide->getHyperlinkQueries()->getAnyHyperlinks() as $container) {
$found[] = $container;
}
}
}
public function collectContainers($presentation) {
$found = [];
foreach ($presentation->getHyperlinkQueries()->getAnyHyperlinks() as $container) {
$found[] = $container;
}
$masters = $presentation->getMasters();
for ($index = 0; $index < java_values($masters->size()); $index++) {
$this->addScope($found, $masters->get_Item($index));
}
$layouts = $presentation->getLayoutSlides();
for ($index = 0; $index < java_values($layouts->size()); $index++) {
$this->addScope($found, $layouts->get_Item($index));
}
$slides = $presentation->getSlides();
for ($index = 0; $index < java_values($slides->size()); $index++) {
$this->addScope($found, $slides->get_Item($index)->getNotesSlideManager()->getNotesSlide());
}
$this->addScope($found, $presentation->getMasterNotesSlideManager()->getMasterNotesSlide());
$this->addScope($found, $presentation->getMasterHandoutSlideManager()->getMasterHandoutSlide());
$seen = new Java('java.util.IdentityHashMap');
$unique = [];
foreach ($found as $container) {
if (!java_values($seen->containsKey($container))) {
$seen->put($container, true);
$unique[] = $container;
}
}
return $unique;
}
public function addRow(&$rows, $presentation, $link, $activation, $container, $containerId) {
if (java_is_null($link)) return;
$ownerSlide = java_instanceof($container, java('com.aspose.slides.ISlideComponent')) ? $container->getSlide() : null;
$targetSlide = $link->getTargetSlide();
$violation = $this->policyViolation($link);
$ownerType = java_instanceof($container, java('com.aspose.slides.IShape')) ? 'Shape' : (java_instanceof($container, java('com.aspose.slides.IPortionFormat')) ? 'Text portion' : java_values($container->getClass()->getSimpleName()));
$action = java_values($link->getActionType());
$ordinaryAction = $action === HyperlinkActionType::Hyperlink || $action === HyperlinkActionType::JumpSpecificSlide;
$externalUrl = java_values($link->getExternalUrl());
$originalUrl = java_values($link->getExternalUrlOriginal());
$rows[] = [
'ContainerId' => $containerId,
'SlideIndex' => $this->slideIndex($presentation, $ownerSlide),
'SlideId' => java_is_null($ownerSlide) ? null : java_values($ownerSlide->getSlideId()),
'Scope' => java_is_null($ownerSlide) ? null : java_values($ownerSlide->getClass()->getSimpleName()),
'OwnerType' => $ownerType,
'Activation' => $activation,
'ActionType' => $action,
'ExternalUrl' => $externalUrl,
'TargetSlideIndex' => $this->slideIndex($presentation, $targetSlide),
'TargetSlideId' => java_is_null($targetSlide) ? null : java_values($targetSlide->getSlideId()),
'Tooltip' => java_values($link->getTooltip()),
'OriginalExternalUrl' => $originalUrl === $externalUrl ? null : $originalUrl,
'PotentiallyUnsafe' => $violation !== null,
'PolicyViolation' => $violation,
'TargetExport' => 'PDF',
'PotentiallyUnsupportedByExport' => $activation === 'mouse-over' || !$ordinaryAction
];
}
}
$replaceExternalClicks = true;
$replacementUrl = 'https://example.com/blocked-link';
$audit = new HyperlinkAudit();
$presentation = new Presentation('hyperlink-audit-input.pptx');
try {
$containers = $audit->collectContainers($presentation);
$rows = [];
foreach ($containers as $index => $container) {
$audit->addRow($rows, $presentation, $container->getHyperlinkClick(), 'click', $container, $index + 1);
$audit->addRow($rows, $presentation, $container->getHyperlinkMouseOver(), 'mouse-over', $container, $index + 1);
}
$json = json_encode($rows, JSON_PRETTY_PRINT | JSON_UNESCAPED_SLASHES);
if ($json === false) {
echo 'Unable to encode the audit report: ' . json_last_error_msg() . PHP_EOL;
} elseif (file_put_contents('hyperlink-audit.json', $json . PHP_EOL) === false) {
echo 'Unable to write the audit report.' . PHP_EOL;
} else {
foreach ($containers as $container) {
$click = $container->getHyperlinkClick();
if ($audit->policyViolation($click) !== null) {
if ($replaceExternalClicks && java_values($click->getActionType()) === HyperlinkActionType::Hyperlink) {
$container->getHyperlinkManager()->setExternalHyperlinkClick($replacementUrl);
} else {
$container->getHyperlinkManager()->removeHyperlinkClick();
}
}
if ($audit->policyViolation($container->getHyperlinkMouseOver()) !== null) {
$container->getHyperlinkManager()->removeHyperlinkMouseOver();
}
}
$presentation->save('hyperlink-sanitized.pptx', SaveFormat::Pptx);
$reopened = new Presentation('hyperlink-sanitized.pptx');
try {
$remainingContainers = $audit->collectContainers($reopened);
$violations = 0;
foreach ($remainingContainers as $container) {
if ($audit->policyViolation($container->getHyperlinkClick()) !== null) $violations++;
if ($audit->policyViolation($container->getHyperlinkMouseOver()) !== null) $violations++;
}
echo 'Audit rows: ' . count($rows) . '; prohibited actions after reopening: ' . $violations . PHP_EOL;
if ($violations !== 0) {
echo 'Verification failed: do not distribute the saved presentation.' . PHP_EOL;
}
} finally {
$reopened->dispose();
}
}
} finally {
$presentation->dispose();
}
مع المدخلات التي تم إنشاؤها أعلاه، يحتوي التقرير على خمس صفوف إجراءات. يُزال رابط المرور فوق الملف والماكرو للنقر، بينما تبقى روابط HTTPS والتنقل الداخلي بين الشرائح. يطبع التحقق صفر إجراءات محظورة. مدخل يحتوي على URL نقر خارجي غير مسموح به يُظهر فرع الاستبدال. حاوية ذات نقر مسموح به ومرور فوق محظور تحتفظ بإجراء النقر.
هذا التنظيف الانتقائي يختلف عن removeAllHyperlinks، الذي يزيل كلا نوعي التنشيط في النطاق المحدد بغض النظر عن السياسة. يتحقق التحقق هنا من إجراءات الارتباط فقط؛ لا يزيل مشاريع VBA المدمجة، كائنات OLE، أو محتوى نشط آخر، ولا يتحقق من ملف PDF أو HTML المُصدَّر.
الأسئلة المتكررة
كيف يمكنني ربط قسم أو شريحته الأولى؟
تُجَمِّع الأقسام في PowerPoint شرائح، لكن الارتباط الداخلي يستهدف شريحة واحدة. لإنشاء تنقل إلى قسم، اربط إلى الشريحة الأولى في ذلك القسم.
هل يمكنني إرفاق ارتباط تشعبي لعناصر الشريحة الأساسية ليعمل على جميع الشرائح؟
نعم. تدعم عناصر الشريحة الأساسية والتخطيطات الروابط التشعبية. تكون الروابط على هذه العناصر متاحة أثناء عرض الشرائح على الشرائح التي تستخدم الماستر أو التخطيط المقابل.
هل ستُحفظ الروابط عند التصدير إلى PDF أو HTML أو صور أو فيديو؟
قد تحافظ تصديرات PDF وHTML المدعومة على الروابط؛ لا يمكن للصور النقطية والفيديو الحفاظ على الروابط التفاعلية. انظر الاعتبارات الخاصة بالتصدير في الإبلاغ، التطهير، والتحقق من الروابط.