Drupal - sgml/signature GitHub Wiki

drupal-project/
└── modules/
    └── custom/
        └── xslt_processor/
            ├── src/
            │   ├── Controller/
            │   ├── Plugin/
            │   │   └── Field/
            │   │       └── Formatter/
            │   └── StackMiddleware/
            │       └── XmlMiddleware.php
            ├── xslt_processor.info.yml
            ├── xslt_processor.services.yml
            └── xslt_processor.module

// src/StackMiddleware/XmlMiddleware.php
// Reference: https://www.drupal.org/docs/8/api/services-and-dependency-injection/middleware-api
namespace Drupal\xslt_processor\StackMiddleware;

use Symfony\Component\HttpKernel\HttpKernelInterface;
use Symfony\Component\HttpFoundation\Request;
use Symfony\Component\HttpFoundation\Response;
use Symfony\Component\HttpKernel\HttpKernel;

class XmlMiddleware implements HttpKernelInterface {
  protected $httpKernel;

  public function __construct(HttpKernelInterface $httpKernel) {
    $this->httpKernel = $httpKernel;
  }

  public function handle(Request $request, int $type = HttpKernel::MAIN_REQUEST, bool $catch = true): Response {
    $response = $this->httpKernel->handle($request, $type, $catch);

    if ($response->headers->get('Content-Type') === 'application/xml') {
      $xslt = new \XSLTProcessor();
      $xsl = new \DOMDocument();
      $xsl->load('modules/custom/xslt_processor/identity_stylesheet.xsl');

      $xslt->importStylesheet($xsl);
      $xml = new \DOMDocument();
      $xml->loadXML($response->getContent());

      $xslt_version = $xsl->documentElement->getAttribute('version');
      $xslt->setParameter('', 'xslt_processor_version', $xslt_version);

      $transformed = $xslt->transformToXML($xml);
      $response->setContent($transformed);
      $response->headers->set('Content-Length', strlen($transformed));

      \Drupal::logger('xslt_processor')->info('XSLT Processor Version: @version', ['@version' => $xslt_version]);
    }

    return $response;
  }
}

php_xsltprocessor:
  description: "The XSLTProcessor class in PHP allows setting parameters programmatically, which can be useful for command-line scripts."
  usage: |
    $xsltProcessor = new XSLTProcessor();
    $xsltProcessor->setParameter('name', 'value');
  params:
    - xsl:param
    - xsl:value-of
  reference: "https://www.php.net/manual/en/class.xsltprocessor.php"

# xslt_processor.services.yml
services:
  xslt_processor.middleware:
    class: Drupal\xslt_processor\StackMiddleware\XmlMiddleware
    arguments: ['@http_kernel']
    tags:
      - { name: http_middleware, priority: 100 }

# xslt_processor.info.yml
name: 'XSLT Processor'
type: module
description: 'Integrate XSLTProcessor with Drupal 11 for XML transformations.'
core_version_requirement: ^8 || ^9 || ^10 || ^11
package: Custom
dependencies:
  - drupal:field
  - drupal:twig_tweak

// mymodule.module
function mymodule_preprocess_node(&$variables) {
  $node = $variables['node'];

  // Convert node to XML
  $xml = new \DOMDocument();
  $xml_node = $xml->createElement("node");
  $xml->appendChild($xml_node);

  $title = $xml->createElement("title", htmlspecialchars($node->title->value));
  $xml_node->appendChild($title);

  $body = $xml->createElement("body", htmlspecialchars($node->body->value));
  $xml_node->appendChild($body);

  // Add XSLT processor version
  $xslt_processor_version = '1.0'; // Static value for demonstration, replace with actual logic
  $version = $xml->createElement("xslt_processor_version", htmlspecialchars($xslt_processor_version));
  $xml_node->appendChild($version);

  $variables['node_xml'] = $xml->saveXML();
}

<!-- path/to/identity_stylesheet.xsl -->
<xsl:stylesheet version="1.0" xmlns:xsl="http://www.w3.org/1999/XSL/Transform">
  <xsl:template match="node()|@*">
    <xsl:copy>
      <xsl:apply-templates select="node()|@*"/>
    </xsl:copy>
  </xsl:template>
</xsl:stylesheet>

# mymodule.theme.yml
# Reference: https://www.drupal.org/docs/8/theming/twig/create-and-register-a-theme-suggestion-in-a-module
theme:
  node__content:
    variables:
      node_xml: NULL
    template: node--content
    base hook: page  # Reference to the default theme base hook for Drupal 11

// mymodule.module
// mymodule.module
/**
 * Implements hook_theme().
 */
function mymodule_theme() {
  return [
    'node__content' => [
      'variables' => ['node_xml' => NULL],
      'template' => 'node--content',
      'base hook' => 'page',  // Reference to the default theme base hook for Drupal 11
    ],
  ];
}

/**
 * Preprocess function for nodes.
 */
// Reference: https://www.drupal.org/docs/8/theming/twig/create-and-register-a-theme-suggestion-in-a-module
function mymodule_preprocess_node(&$variables) {
  $node = $variables['node'];

  // Convert node to XML
  $xml = new \DOMDocument();
  $xml_node = $xml->createElement("node");
  $xml->appendChild($xml_node);

  $title = $xml->createElement("title", htmlspecialchars($node->title->value));
  $xml_node->appendChild($title);

  $body = $xml->createElement("body", htmlspecialchars($node->body->value));
  $xml_node->appendChild($body);

  // Add XSLT processor version
  $xslt_processor_version = '1.0'; // Static value for demonstration
  $version = $xml->createElement("xslt_processor_version", htmlspecialchars($xslt_processor_version));
  $xml_node->appendChild($version);

  $variables['node_xml'] = $xml->saveXML();
}

// node--content.tpl.php
// Reference: https://www.drupal.org/docs/8/theming/twig/create-and-register-a-theme-suggestion-in-a-module
<?php
  // Load the XML content
  $xml = new DOMDocument();
  $xml->loadXML($node_xml);

  // Initialize the XSLT processor
  $xslt = new XSLTProcessor();
  $xsl = new DOMDocument();
  $xsl->load('path/to/identity_stylesheet.xsl');

  // Import the stylesheet
  $xslt->importStylesheet($xsl);

  // Transform the XML
  $transformed = $xslt->transformToXML($xml);

  // Use heredoc for HTML content
  $html = <<<HTML
  <h1>XSLT Processor Version: {$xml->getElementsByTagName('xslt_processor_version')->item(0)->nodeValue}</h1>
  <h2>Title: {$xml->getElementsByTagName('title')->item(0)->nodeValue}</h2>
  <p>Body: {$xml->getElementsByTagName('body')->item(0)->nodeValue}</p>
  HTML;

  // Output the transformed content
  echo $html;
?>

drupal_module_upgrader_installation:
  steps:
    - step: "Install Drush"
      description: "Ensure you have a modern version of Drush installed. Check the installation documentation on the Drush website for guidance."
      url: "https://www.drush.org/latest/install/"

    - step: "Install Composer"
      description: "DMU requires Composer. Make sure you have Composer installed on your system."
      url: "https://getcomposer.org/download/"

    - step: "Download DMU"
      command: "drush dl drupalmoduleupgrader"
      description: "Navigate to your Drupal 8 web root and run the command to download the DMU module."
      url: "https://www.drupal.org/project/drupalmoduleupgrader"

    - step: "Install Dependencies"
      command: "cd drupalmoduleupgrader && composer install"
      description: "Navigate to the DMU directory and run Composer to install the required dependencies."

    - step: "Enable DMU"
      command: "drush en drupalmoduleupgrader -y"
      description: "Enable the DMU module using Drush."

    - step: "Analyze or Upgrade"
      description: "Move your Drupal 7 module into the Drupal 8 modules directory."
      analyze_command: "drush dmu -analyze MODULE_NAME"
      upgrade_command: "drush dmu -upgrade MODULE_NAME"
      analyze_description: "To analyze the module and generate a report."
      upgrade_description: "To upgrade the module."

    - step: "Set Environment Variables for DMU"
      description: "Configure the necessary environment variables for Drupal Module Upgrader."
      environment_variables:
        - name: "DMU_ROOT"
          value: "The root directory of the Drupal installation."
        - name: "DMU_MODULES"
          value: "The directory containing the Drupal modules to be upgraded."
        - name: "DMU_BACKUP"
          value: "The directory where backups of the modules will be stored."