이미지가 업로드되지 않거나 사라집니다.

Learn DXPR BuilderManage the siteRegelen wie wat kan doen

업로드를 되살리고 업로드된 파일을 사이트에 유지합니다. 이미지는 빌더 자체 업로드나 사이트가 쓰는 경우 Media Library를 통해 페이지에 도착합니다. 대부분의 실패는 미디어 설정, 파일 권한, 서버에 닿지 못한 업로드 때문입니다.

미디어 브라우저가 없거나 비어 있습니다

  1. 다음 경로로 이동하여 섹션을 엽니다. DXPR Studio > DXPR Builder > General Settings (/admin/dxpr_studio/dxpr_builder/settings)에서 Media 섹션을 엽니다.
  2. 다음을 설정하고 클릭합니다. Browser type을 Media Library로 설정하고 Save settings를 클릭합니다. 해당 옵션은 코어 Media Library 모듈이 활성화될 때만 표시됩니다. Acquia DAM을 쓰면 Media Library (Acquia DAM)을 선택합니다.
  3. 다음으로 이동하여 머신 이름을 확인합니다. Structure > Media types로 이동하고 머신 이름이 image인 미디어 유형이 있는지 확인합니다(동영상은 video). 빌더는 해당 유형에서 Media Library를 엽니다.

Note: Basic file upload는 컴퓨터에서 직접 업로드하는 일반 Select image 버튼을 표시합니다. Media Library가 활성화되지 않았을 때 기본값입니다. Entity Browser는 레거시 옵션입니다. Media Library를 권장합니다.

업로드가 오류와 함께 실패합니다

  • "Destination file path is not writable" or "File could not be saved". 웹 서버가 파일 디렉터리에 쓸 수 없습니다. 웹 서버 사용자용으로 sites/default/files를 쓰기 가능하게 만든 뒤 Reports > Status report를 확인합니다.
  • "Only files with the following extensions are allowed". 빌더는 GIF, JPEG, PNG, WebP, AVIF, SVG 이미지와 WebM, Ogg, MP4 동영상을 받습니다. Media Library에서는 미디어 유형이 정합니다. 이미지 필드의 Allowed file extensions 아래에 확장자를 추가합니다. 위치는 Structure > Media types > Image > Manage fields입니다.
  • "exceeding the maximum file size", or "The uploaded video is too large". 파일이 PHP 허용량보다 큽니다. PHP에서 upload_max_filesize와 post_max_size, 웹 서버나 프록시의 본문 크기 제한을 높입니다.
  • 403 또는 405 /dxpr_builder/ajax/file_upload 오류. 프록시나 방화벽이 해당 경로의 POST 요청을 차단하거나 리디렉션합니다. 허용 목록에 추가하고 사이트가 리디렉션하지 않는지 확인합니다. 예를 들면 HTTP에서 HTTPS로 바뀌지 않아야 합니다.
  • 미디어 브라우저 안에서 편집자에게 “Access denied” 메시지가 표시됩니다. 역할에는 Media Library를 여는 View media와 업로드용 Image: Create new media가 필요합니다. 둘 다 People > Permissions에서 부여합니다.

업로드 몇 시간 후 이미지가 사라집니다

파일이 sites/default/files/dxpr_builder_images에서 사라졌고 페이지에 깨진 이미지가 표시됩니다.

3.0.0-alpha85 이전 릴리스는 Media 모듈이 꺼져 있을 때 빌더 업로드를 임시 파일로 저장했습니다. Drupal의 cron은 6시간 뒤 임시 파일을 삭제합니다.

  1. 현재 릴리스로 업데이트합니다. 업로드를 영구 파일로 저장하고 사용 내역을 기록합니다.
  2. 빠진 이미지를 다시 업로드하거나 백업에서 같은 폴더로 복원합니다.

Note: 업로드는 기본 파일 디렉터리의 dxpr_builder_images, dxpr_builder_videos, dxpr_builder_files에 들어갑니다.

에디터에는 보이지만 방문자에게는 보이지 않습니다

  • 다시 로드하면 이미지가 사라졌습니다. 컨테이너가 저장되지 않았습니다. 이미지를 다시 추가하고 컨테이너 표시줄에서 Save를 클릭합니다.
  • 이미지는 보이지만 방문자에게는 보이지 않습니다. Apply text format filters to frontend content가 General Settings > Text Filters 아래에서 켜져 있으며, 필드의 텍스트 형식이 img 태그나 속성을 제거합니다. 에디터는 항상 필터링되지 않은 콘텐츠를 봅니다. 설정을 끄거나 해당 텍스트 형식에서 img를 허용합니다.
  • 방문자에게 이전 버전의 페이지가 보입니다. 캐시가 이전 페이지를 제공합니다. Visitors see something different을 참조합니다.

수정 확인하기

Image 요소에 이미지를 업로드하고 컨테이너를 저장합니다. 비공개 창에서 익명 방문자에게 이미지가 표시됩니다.

다음 단계

Media Library integration은 빌더에서 기존 미디어를 재사용할 때 확인합니다.