제품 키 입력과 사이트 전체 설정.

Learn DXPR BuilderManage the siteDe builder configureren

사이트와 DXPR 구독의 연결은 General Settings 탭에서 제품 키로 이루어집니다. 또한 모든 편집자에게 적용되는 설정(컨트롤 바, 텍스트 스타일, Bootstrap, 미디어 브라우저)을 선택합니다. 빌더를 설치하거나 구독을 변경하거나 미디어 브라우저를 바꿀 때 이곳을 찾으세요. AI 기능은 별도의 탭에 있습니다. AI configuration 문서를 참고하세요.

시작하기 전에

  • 사용자의 역할에 Administer DXPR Builder configuration 권한이 필요합니다.
  • 제품 키를 준비하세요. 탭의 Find your product key 링크를 클릭하면 dxpr.com/getting-started 페이지가 열립니다.

설정

  1. 다음 경로로 이동하세요: DXPR Studio > DXPR Builder > General Settings (/admin/dxpr_studio/dxpr_builder/settings).
  2. 키 저장 위치는 License에서 Storage method(으)로 선택하세요.
  3. 키 저장 방식으로 Configuration storage를 사용하는 경우 Product key에 키를 붙여넣으세요. Key module을 사용하는 경우 Key에서 해당 키를 담고 있는 키를 선택하세요.
  4. 다른 섹션을 열어 필요한 항목을 변경하세요. 각 항목의 설명은 아래 Settings 표를 참고하세요.
  5. 마지막으로 Save settings(을)를 클릭하세요.

Configuration storage는 키를 사이트 설정과 함께 저장합니다. Key module은 Manage keys(/admin/config/system/keys)에서 관리하는 키에서 값을 읽어옵니다. 키의 공급자에 따라 값은 데이터베이스가 아니라 파일이나 환경 변수에 둘 수 있습니다.

라이선스, 텍스트 에디터, Bootstrap 섹션이 있는 DXPR Builder General Settings 탭

표시되는 내용

폼이 저장된 값과 함께 다시 열리며 “The configuration options have been saved.” 메시지가 표시됩니다. License 섹션은 열린 채로 유지되고, 다른 섹션은 접힙니다. 키가 작동하는지 확인하려면 User Licenses 탭을 여세요. 상단의 상자에 구독 등급과 라이선스 수가 표시됩니다. 이제 편집자에게는 DXPR Builder 필드가 있는 페이지에 빌더 컨트롤이 표시됩니다.

설정

설정 기능 기본값
Storage method (License) 제품 키의 보관 위치: Configuration storage 또는 Key module. Configuration storage
Product key (License) 제품 키. Configuration storage를 사용할 때만 표시됩니다. 비어 있음
Key (License) 제품 키를 담고 있는 키. Key module을 사용할 때만 표시됩니다. 이 폼을 저장해도 키 값은 바뀌지 않습니다. Manage keys에서 편집하세요. 없음
Scroll offset selector (Advanced Settings) 고정되거나 스티키인 헤더의 CSS 선택자. 앵커로의 부드러운 스크롤이 해당 헤더 아래에서 멈춥니다. .dxpr-theme-header--sticky, .dxpr-theme-header--fixed
Control bars (Advanced Settings) 편집자가 요소의 컨트롤 바를 찾는 위치. On each element: 모든 요소에 각자의 바가 표시됩니다. One row: 가리키는 요소 위에 한 줄의 바가 표시되며, 페이지는 게시된 레이아웃을 유지합니다. user profile에서 역할별로 다르게 설정할 수 있으며, 각 편집자는 에디터나 계정 페이지의 Editor settings에서 선택할 수 있습니다. On each element
Custom styles (Text Editor) 텍스트 에디터의 Styles 목록 항목. [label]=[element].[class] 형식으로 한 줄에 하나씩 입력합니다(예: Sassy Title=h1.sassy-title). 필드를 비우면 기본 제공 목록으로 돌아갑니다. Text editor 문서를 참고하세요. DXPR Builder 기본 제공 스타일. 첫 항목은 Lead=p.lead
Sideload Bootstrap files (Bootstrap) None (theme provides Bootstrap) 또는 Bootstrap 5(빌더가 해당 페이지에 Bootstrap을 직접 불러오도록 함). 선택 없음. 따라서 Bootstrap 파일이 불러와지지 않음
Browser type (Media) 편집자의 이미지 선택 방식: Basic file upload, Media Library, Acquia DAM 모듈과 함께 사용하는 Media Library (Acquia DAM), 또는 Entity Browser 모듈과 함께 사용하며 머신 네임으로 표시되는 엔터티 브라우저. Media Library 문서를 참고하세요. Media Library(해당 모듈이 켜져 있는 경우), 아니면 Basic file upload
Apply text format filters to frontend content (Text Filters) 방문자에게 표시되는 필드에 텍스트 형식 필터를 실행합니다. 빌더로 편집할 수 있는 사용자에게는 필터링되지 않은 콘텐츠가 표시됩니다. 일부 필터는 빌더 마크업과 함께 작동하지 않을 수 있습니다. 꺼짐
Asset source (Editor Assets) 에디터 JavaScript의 출처: Cloud, Local (minified), Local (unminified). 이 섹션은 모듈에 로컬 빌드가 있을 때만 표시됩니다. 로컬 파일이 있는 동안에는 Cloud도 해당 파일을 불러옵니다. 클라우드 파일은 릴리스에만 존재하기 때문입니다. Editor assets 문서를 참고하세요. Cloud

오류가 표시되거나 빌더가 표시되지 않는 경우

  • Product key 아래에 “Product key required” 메시지가 표시됩니다. Storage method가 Configuration storage인데 필드가 비어 있습니다. 키를 붙여넣거나, Key module(을)를 선택하고 키를 고르세요.
  • “Invalid product key. Copy the complete key without extra spaces.” 메시지가 표시됩니다. 붙여넣은 텍스트가 온전한 키가 아니거나, DXPR Builder 1.x용으로 만든 키입니다. Find your product key 링크에서 현재 키를 공백이나 줄 바꿈 없이 다시 복사하세요.
  • Key 아래에 “Select a key” 메시지가 표시됩니다. Key module(을)를 선택했지만 키를 고르지 않았습니다. 키를 고르거나, 먼저 Manage keys(/admin/config/system/keys)에서 키를 만드세요.
  • Key 아래에 “The selected key does not hold a valid product key.” 메시지가 표시됩니다. 선택한 키에 AI 공급자의 키 같은 다른 보안 값이 들어 있습니다. 제품 키를 담고 있는 키를 고르거나, Manage keys에서 제품 키를 해당 키에 붙여넣으세요.
  • Product key 필드가 사라졌습니다. Storage method가 Key module(으)로 설정되어 있습니다. 모듈 업데이트로 키가 Configuration storage에서 DXPR Builder JWT라는 키로 옮겨졌을 수 있으며, 현재 Key에 표시됩니다.
  • “We are having trouble connecting to the DXPR servers”라는 오류가 표시됩니다. 서버에서 DXPR 라이선스 서비스에 연결할 수 없습니다. 허용해야 할 호스트는 Firewall and data residency 문서를 참고하세요.
  • Editor Assets 섹션이 없습니다. 모듈 폴더에 로컬 빌드가 없으므로 에디터는 DXPR CDN에서 불러옵니다. 고칠 필요가 없습니다.

다음 단계