---
url: 'https://dxpr.com/ar/hc/%D8%A7%D9%84%D8%AA%D9%88%D8%AB%D9%8A%D9%82/%D8%AA%D8%B9%D9%84%D9%85-dxpr-builder/%D8%A7%D9%84%D8%A8%D8%AF%D8%A1/%D8%A7%D9%84%D8%AA%D8%AB%D8%A8%D9%8A%D8%AA'
title: 'تثبيت DXPR Builder على موقع Drupal | DXPR'
author:
  name: Jurriaan
  url: 'https://dxpr.com/users/jurriaan'
date: '2023-11-06T06:21:39+00:00'
updated: '2026-10-24T17:19:22+00:00'
copyright: 'Copyright DXPR. All rights reserved.'
type: article
summary: |-
  ثبّتوا DXPR Builder على موقع Drupal تديرونه سلفًا، وأضيفوا مفتاح منتجكم وبدّلوا نوع محتوى واحدًا إلى المنشئ. وفي النهاية تحصلون على صفحة محفوظة تعرض المنشئ، جاهزة لعنصركم الأول. أتبدؤون موقعًا جديدًا بدلًا من ذلك؟ يضبط تثبيت DXPR CMS المنشئ والقالب وأنواع المحتوى دفعة واحدة.
  يمر الفيديو في التثبيت على أنواع المحتوى الموجودة على الخطوات 2 إلى 8 من الفحص في نهاية هذه الصفحة.
tags:
  - 'Install and update'
image: 'https://dxpr.com/themes/custom/dxpr_com/images/dxpr-share-card.jpg'
published: true
og:
  site_name: DXPR
  updated_time: '2026-10-24T17:19:22+0000'
  'image:alt': 'DXPR, powered by Drupal: AI-powered Drupal for marketers.'
schema:
  '@context': 'https://schema.org'
  '@graph':
    -
      mainEntity: {  }
    -
      '@type': TechArticle
      headline: 'تثبيت DXPR Builder على موقع Drupal'
      description: |-
        ثبّتوا DXPR Builder على موقع Drupal تديرونه سلفًا، وأضيفوا مفتاح منتجكم وبدّلوا نوع محتوى واحدًا إلى المنشئ. وفي النهاية تحصلون على صفحة محفوظة تعرض المنشئ، جاهزة لعنصركم الأول. أتبدؤون موقعًا جديدًا بدلًا من ذلك؟ يضبط تثبيت DXPR CMS المنشئ والقالب وأنواع المحتوى دفعة واحدة.
        يمر الفيديو في التثبيت على أنواع المحتوى الموجودة على الخطوات 2 إلى 8 من الفحص في نهاية هذه الصفحة.
      image:
        '@type': ImageObject
        url: 'https://dxpr.com/themes/custom/dxpr_com/images/dxpr-share-card.jpg'
        width: '1200'
        height: '630'
      datePublished: '2023-11-06T06:21:39+0000'
      dateModified: '2026-10-24T17:19:22+0000'
      author:
        '@type': Organization
        '@id': 'https://dxpr.com/#organization'
        name: DXPR
        url: 'https://dxpr.com/'
        logo:
          '@type': ImageObject
          url: 'https://dxpr.com/themes/custom/dxpr_com/dxpr-logo-dark.svg'
          width: '1348'
          height: '501'
      publisher:
        '@type': Organization
        '@id': 'https://dxpr.com/#organization'
        name: DXPR
        url: 'https://dxpr.com/'
        logo:
          '@type': ImageObject
          url: 'https://dxpr.com/themes/custom/dxpr_com/dxpr-logo-dark.svg'
          width: '1348'
          height: '501'
      mainEntityOfPage: 'https://dxpr.com/ar/hc/%D8%A7%D9%84%D8%AA%D9%88%D8%AB%D9%8A%D9%82/%D8%AA%D8%B9%D9%84%D9%85-dxpr-builder/%D8%A7%D9%84%D8%A8%D8%AF%D8%A1/%D8%A7%D9%84%D8%AA%D8%AB%D8%A8%D9%8A%D8%AA'
      articleSection: 'التثبيت والتحديث'
    -
      '@type': WebPage
      '@id': 'https://dxpr.com/ar/hc/%D8%A7%D9%84%D8%AA%D9%88%D8%AB%D9%8A%D9%82/%D8%AA%D8%B9%D9%84%D9%85-dxpr-builder/%D8%A7%D9%84%D8%A8%D8%AF%D8%A1/%D8%A7%D9%84%D8%AA%D8%AB%D8%A8%D9%8A%D8%AA'
      description: |-
        ثبّتوا DXPR Builder على موقع Drupal تديرونه سلفًا، وأضيفوا مفتاح منتجكم وبدّلوا نوع محتوى واحدًا إلى المنشئ. وفي النهاية تحصلون على صفحة محفوظة تعرض المنشئ، جاهزة لعنصركم الأول. أتبدؤون موقعًا جديدًا بدلًا من ذلك؟ يضبط تثبيت DXPR CMS المنشئ والقالب وأنواع المحتوى دفعة واحدة.
        يمر الفيديو في التثبيت على أنواع المحتوى الموجودة على الخطوات 2 إلى 8 من الفحص في نهاية هذه الصفحة.
      breadcrumb:
        '@type': BreadcrumbList
        itemListElement:
          -
            '@type': ListItem
            position: 1
            name: الرئيسية
            item: 'https://dxpr.com/ar'
      publisher:
        '@type': Organization
        '@id': 'https://dxpr.com/#organization'
        name: DXPR
      inLanguage: ar
---
[مركز المساعدة](/ar/hc)/[التوثيق](/ar/hc/%D8%A7%D9%84%D8%AA%D9%88%D8%AB%D9%8A%D9%82) /[تعلّم DXPR Builder](/ar/hc/documentation/learn-dxpr-builder) /[ابدؤوا من هنا](/ar/hc/documentation/learn-dxpr-builder/start-here) /[التثبيت والتحديث](/ar/hc/documentation/learn-dxpr-builder/start-here/install) # تثبيت DXPR Builder على موقع Drupal.

 تعلّم DXPR Builderابدؤوا من هناالتثبيت والتحديث

   ## في هذا الدليل

 أدلة ذات صلة

- [ابنوا صفحتكم الأولى](/ar/hc/%D8%A7%D9%84%D8%AA%D9%88%D8%AB%D9%8A%D9%82/%D8%AA%D8%B9%D9%84%D9%85-dxpr-builder/%D8%A7%D9%84%D8%A8%D8%AF%D8%A1/%D8%A7%D9%84%D8%B5%D9%81%D8%AD%D8%A9-%D8%A7%D9%84%D8%A3%D9%88%D9%84%D9%89)
- [استخدام DXPR Builder على أنواع المحتوى](/ar/hc/%D8%A7%D9%84%D8%AA%D9%88%D8%AB%D9%8A%D9%82/%D8%AA%D8%B9%D9%84%D9%85-dxpr-builder/%D8%A7%D9%84%D8%A8%D8%AF%D8%A1/%D8%A7%D8%B3%D8%AA%D8%AE%D8%AF%D8%A7%D9%85-dxpr-builder-%D8%B9%D9%84%D9%89-%D8%A3%D9%86%D9%88%D8%A7%D8%B9-%D8%A7%D9%84%D9%85%D8%AD%D8%AA%D9%88%D9%89)
- [تحديث DXPR Builder](/ar/hc/%D8%A7%D9%84%D8%AA%D9%88%D8%AB%D9%8A%D9%82/%D8%AA%D8%B9%D9%84%D9%85-dxpr-builder/%D8%A7%D9%84%D8%A8%D8%AF%D8%A1/%D8%AA%D8%AD%D8%AF%D9%8A%D8%AB-dxpr-builder)

ثبّتوا DXPR Builder على موقع Drupal تديرونه سلفًا، وأضيفوا مفتاح منتجكم وبدّلوا نوع محتوى واحدًا إلى المنشئ. وفي النهاية تحصلون على صفحة محفوظة تعرض المنشئ، جاهزة لعنصركم الأول. أتبدؤون موقعًا جديدًا بدلًا من ذلك؟ يضبط [تثبيت DXPR CMS](/ar/hc/documentation/learn-dxpr-builder/getting-started/installing-dxpr-cms) المنشئ والقالب وأنواع المحتوى دفعة واحدة.

يمر الفيديو في [التثبيت على أنواع المحتوى الموجودة](/ar/hc/documentation/learn-dxpr-builder/getting-started/installing-on-existing-content-types) على الخطوات 2 إلى 8 من الفحص في نهاية هذه الصفحة.

## قبل أن تبدؤوا

- Drupal 10.2 أو أحدث، بما فيه Drupal 11، مع PHP 8.1 أو أحدث. تسرد [المتطلبات](/ar/hc/%D8%A7%D9%84%D8%AA%D9%88%D8%AB%D9%8A%D9%82/%D8%AA%D8%B9%D9%84%D9%85-dxpr-builder/%D8%A7%D9%84%D8%A8%D8%AF%D8%A1/%D8%A7%D9%84%D9%85%D8%AA%D8%B7%D9%84%D8%A8%D8%A7%D8%AA) الباقي.
- Composer وDrush في مشروعكم.
- مفتاح منتج. يحتاجه DXPR Builder ليعمل؛ تجدون مفتاحكم في [dxpr.com/getting-started](/ar/%D8%A7%D9%84%D8%A8%D8%AF%D8%A1/%D8%A7%D9%84%D8%A7%D8%B4%D8%AA%D8%B1%D8%A7%D9%83).

## تثبيت الوحدة

1. نزّلوا DXPR Builder 3.x باستخدام Composer. يُنشر الإصدار 3 كإصدارات تجريبية، فاسمحوا بها:

    ```bash
    composer require 'drupal/dxpr_builder:^3.0@beta'

    ```

    أما `composer require drupal/dxpr_builder` العادي فيثبّت سلسلة 2.x المستقرة بدلًا من ذلك.
2. فعّلوا الوحدة:

    ```bash
    drush en dxpr_builder

    ```

    ويفعّل Drush أيضًا وحدة Key ووحدات النواة التي يحتاجها DXPR Builder: الحقل وواجهة الحقل وViews والصورة والكتلة.

## إضافة مفتاح المنتج

1. انتقلوا إلى **DXPR Studio** > **DXPR Builder** > **الإعدادات العامة**(`/admin/dxpr_studio/dxpr_builder/settings`).
2. في قسم **الترخيص**، اختاروا **طريقة التخزين**.
3. لـ**تخزين الإعدادات**، الصقوا المفتاح في **مفتاح المنتج**. ولـ**وحدة Key**، اختاروا مفتاحكم تحت **المفتاح**.
4. انقروا **حفظ الإعدادات**.

**تخزين الإعدادات** يُبقي المفتاح في إعدادات الموقع، فينتهي في صادرات الإعدادات. وتقرأه **وحدة Key** من مفتاح تنشئونه أولًا في `/admin/config/system/keys`. امنحوا ذلك المفتاح موفّر **الملف** أو **البيئة** لإبعاده عن الصادرات أيضًا.

## إضافة الوحدات الفرعية (اختياري)

يُشحن DXPR Builder مع ثلاث وحدات فرعية. فعّلوا واحدة بـ `drush en` واسمها.

| الوحدة الفرعية | ما تضيفه | تحتاج |
|---|---|---|
| `dxpr_builder_page` | نوع المحتوى **صفحة السحب والإفلات**، المضبوط على المنشئ سلفًا | وحدة [Field Group](https://www.drupal.org/project/field_group) المساهمة |
| `dxpr_builder_block` | نوع الكتلة **كتلة السحب والإفلات**، لمحتوى المنشئ في مناطق الكتل | وحدة نواة **محتوى الكتل**، مفعّلة أولًا |
| `dxpr_builder_media` | متصفح وسائط قديم مبني على Entity Browser؛ مخفي في صفحة **التوسعة** للوحدات | Entity Browser وInline Entity Form |

لا تحتاج معظم المواقع وحدة وسائط. فعندما تكون وحدة **مكتبة الوسائط** الأساسية مفعّلة وقت التثبيت، يستخدمها المنشئ. وإلا فاختاروها لاحقًا تحت **الوسائط** > **نوع المتصفح** في صفحة الإعدادات. لدى [بنية الوحدات الفرعية](/ar/hc/%D8%A7%D9%84%D8%AA%D9%88%D8%AB%D9%8A%D9%82/%D8%AA%D8%B9%D9%84%D9%85-dxpr-builder/%D8%A7%D9%84%D8%AA%D8%B7%D9%88%D9%8A%D8%B1/%D8%A7%D9%84%D9%88%D8%AD%D8%AF%D8%A7%D8%AA-%D8%A7%D9%84%D9%81%D8%B1%D8%B9%D9%8A%D8%A9) التفاصيل.

## تشغيل ميزات الذكاء الاصطناعي (اختياري)

يعمل إنشاء الصفحات والنصوص والصور بالذكاء الاصطناعي عبر وحدة [AI](https://www.drupal.org/project/ai) و[DXPR AI Provider](https://www.drupal.org/project/ai_provider_dxpr).

1. نزّلوا الوحدتين:

    ```bash
    composer require drupal/ai drupal/ai_provider_dxpr

    ```
2. فعّلوهما:

    ```bash
    drush en ai ai_provider_dxpr

    ```
3. انتقلوا إلى `/admin/config/ai/providers/dxpr`، واختاروا المفتاح الذي يحمل مفتاح منتجكم تحت **مفتاح DXPR API**، واحفظوا.
4. انتقلوا إلى `/admin/dxpr_studio/dxpr_builder/ai_settings`. تحت **ميزات الذكاء الاصطناعي**، تكون المربعات الثلاثة كلها معلّمة افتراضيًا. ألغوا تحديد أي ميزة لا تريدونها.

يشرح [دليل ميزات الذكاء الاصطناعي](/hc/documentation/learn-dxpr-builder/ai) كل إعداد.

## التحقق من التثبيت

يظهر المنشئ على المحتوى الذي يستخدم حقل النص فيه منسّق **DXPR Builder**. وتضبط هذه الخطوات المنسّق على نوع محتوى مع حقل **Body**. أما النوع **صفحة السحب والإفلات** من `dxpr_builder_page` فمضبوط سلفًا، فتخطّوا هناك الخطوات 2 إلى 5.

1. انتقلوا إلى **DXPR Studio** > **DXPR Builder** > **الإعدادات العامة** وتأكدوا من وجود مفتاح منتجكم في قسم **الترخيص**.
2. انتقلوا إلى **البنية** > **أنواع المحتوى**. افتحوا القائمة بجانب نوع محتوى مع حقل **Body** وانقروا **إدارة العرض**.
3. إذا فُتحت نظرة عامة على أنماط العرض، فانقروا **إدارة** لـ**الافتراضي**.
4. غيّروا **تنسيق** Body إلى **DXPR Builder**.
5. انقروا **حفظ**.
6. أنشئوا محتوى من ذلك النوع واكتبوا **عنوانًا**.
7. انقروا **حفظ**.
8. حوموا فوق منطقة المحتوى. فيظهر شريط أدوات DXPR Builder.

## ما ترونه

تعرض الصفحة المحفوظة منشئًا فارغًا حيث كان نص المتن. وهو يقدّم أمرًا نصيًا للذكاء الاصطناعي، معطّلًا حتى يُعدّ الذكاء الاصطناعي، مع **اختيار قالب** و**إضافة العناصر**. انقروا **إضافة العناصر**: فيُفتح منتقي العناصر مع تبويبَي **التخطيط** و**المحتوى**. DXPR Builder يعمل.

## إذا لم يظهر المنشئ

- **تعرض الصفحة نص المتن، لكن بلا منشئ.** ما زال الحقل يستخدم منسّقًا آخر. اضبطوا **تنسيقه** على **DXPR Builder** في نمط العرض **الافتراضي** تحت **البنية** > **أنواع المحتوى** > **إدارة العرض**.
- **يعرض نموذج التحرير منطقة نص عادية.** يعمل DXPR Builder على الصفحة المحفوظة، وليس على نموذج التحرير. احفظوا المحتوى وافتحوا صفحته.
- **يظهر المنشئ للمسؤول فقط.** تفتقر الأدوار الأخرى إذن **Edit with DXPR Builder**. امنحوه في **الأشخاص** > **الأذونات** (`/admin/people/permissions`).
- **يرى محرر ثانٍ «يمكن لحساب واحد فقط استخدام DXPR Builder على المستوى المجاني لـ DXPR».** يسمح المستوى المجاني بمحرر واحد. أدخلوا مفتاح منتج من اشتراك مدفوع تحت **الترخيص**.
- **يقول خطأ «مفتاح منتجكم غير صالح».** رفضت شبكة CDN الخاصة بـ DXPR المفتاح. الصقوا المفتاح الكامل مجددًا تحت **الترخيص** في `/admin/dxpr_studio/dxpr_builder/settings`.
- **يقول خطأ «تعذّر تحميل موارد DXPR Builder السحابية».** لا يستطيع المتصفح الوصول إلى `cdn2.dxpr.com` أو `cdn.dxpr.com`. اسمحوا بالمضيفين كليهما، كما يشرح [جدار الحماية وإقامة البيانات](/ar/hc/documentation/learn-dxpr-builder/getting-started/behind-a-firewall).
- **يقول الأمر النصي للذكاء الاصطناعي «تتطلب ميزات الذكاء الاصطناعي وحدة AI».** لم تُعدّ وحدات الذكاء الاصطناعي بعد. اتبعوا [تشغيل ميزات الذكاء الاصطناعي](#turn-on-ai-features-optional)، أو ألغوا تحديد الميزات تحت **ميزات الذكاء الاصطناعي** في `/admin/dxpr_studio/dxpr_builder/ai_settings`.
- **يبلّغ حفظ الإعدادات عن «مفتاح منتج غير صالح».** النص الملصق ليس مفتاحًا كاملًا، أو هو مفتاح مصنوع لـ DXPR Builder 1.x. انسخوا مفتاحكم الحالي مجددًا، دون مسافات أو فواصل أسطر.

[المحرر لا يظهر](/ar/hc/%D8%A7%D9%84%D8%AA%D9%88%D8%AB%D9%8A%D9%82/%D8%AA%D8%B9%D9%84%D9%85-dxpr-builder/%D8%A7%D8%B3%D8%AA%D9%83%D8%B4%D8%A7%D9%81-%D8%A7%D9%84%D8%A3%D8%AE%D8%B7%D8%A7%D8%A1-%D9%88%D8%A5%D8%B5%D9%84%D8%A7%D8%AD%D9%87%D8%A7/%D8%A7%D9%84%D9%85%D8%AD%D8%B1%D8%B1-%D9%84%D8%A7-%D9%8A%D8%B8%D9%87%D8%B1)يغطي أسبابًا أكثر.

## ما الخطوة التالية؟

- [صفحتكم الأولى](/ar/hc/%D8%A7%D9%84%D8%AA%D9%88%D8%AB%D9%8A%D9%82/%D8%AA%D8%B9%D9%84%D9%85-dxpr-builder/%D8%A7%D9%84%D8%A8%D8%AF%D8%A1/%D8%A7%D9%84%D8%B5%D9%81%D8%AD%D8%A9-%D8%A7%D9%84%D8%A3%D9%88%D9%84%D9%89): ابنوا صفحة من أقسام وصفوف وعناصر.
- [التثبيت على أنواع المحتوى الموجودة](/ar/hc/documentation/learn-dxpr-builder/getting-started/installing-on-existing-content-types): بدّلوا مزيدًا من أنواع المحتوى، أو أضيفوا حقل منشئ.
- [تحديث DXPR Builder](/ar/hc/%D8%A7%D9%84%D8%AA%D9%88%D8%AB%D9%8A%D9%82/%D8%AA%D8%B9%D9%84%D9%85-dxpr-builder/%D8%A7%D9%84%D8%A8%D8%AF%D8%A1/%D8%AA%D8%AD%D8%AF%D9%8A%D8%AB-dxpr-builder): أبقوا الوحدة حديثة وشغّلوا `drush updatedb` بعد كل تحديث.
- [اختبروا التنويعات](/hc/documentation/learn-dxpr-builder/integrations/ab-testing-overview): اختبار A/B مع وحدة [التعلّم المعزّز](https://www.drupal.org/project/rl).