콘텐츠로 건너뛰기
주의:: 이 문서는 사용자의 편의를 위해 제공됩니다. 이 문서는 번역 소프트웨어를 사용하여 자동으로 번역되었으며 교정을 거치지 않았을 수 있습니다. 이 문서의 영어 버전이 가장 최신의 정보를 확인할 수 있는 공식 버전으로 간주해야 합니다. 여기에서 액세스할 수 있습니다..

디자인 관리자에서 중첩된 모듈 업그레이드하기

마지막 업데이트 날짜: 2월 12, 2025

명시된 경우를 제외하고 다음 구독 중 어느 것에서나 사용할 수 있습니다.

마케팅 Hub   Professional , Enterprise
콘텐츠 Hub   Professional , Enterprise
레거시 Marketing Hub Basic

새 디자인 관리자에서 일부 v1 사용자 정의 모듈은 향후 콘텐츠 제작에 사용하려면 v2 모듈 프레임워크로 업그레이드해야 할 수 있습니다. 새로운 모듈 프레임워크는 더 강력하고 안정적이며 편집기에서 더 나은 경험을 제공합니다.

v2 프레임워크에서 대부분의 v1 모듈을 계속 사용할 수 있지만 모듈의 HTML + HubL 마크업에 포함된 모듈은 더 이상 지원되지 않습니다. v1 사용자 정의 모듈에서는 이러한 중첩된 모듈이 페이지 편집기에서 추가 편집 가능한 모듈로 렌더링됩니다.

새로운 v2 모듈 프레임워크에는 페이지 수준에서 편집할 수 있는 유연한 요소를 모듈에 추가할 수 있는더 강력한모듈 필드가포함되어 있습니다. 따라서 모듈 내에 포함된 모듈에서 발생하는 중복성 및 호환성 문제가 제거되어 전반적으로 디자인 경험이 향상됩니다. HubL 태그는 v2 모듈 프레임워크에서 여전히 지원되지만 특정 모듈 필드 유형을 참조하는 경우에만 지원됩니다. 모듈 편집기에 내장된복사 스니펫 기능을 사용하여 HubL의 형식이 올바르게 지정되었는지 확인할 수 있습니다.

중첩된 모듈 식별하기

템플릿 중 하나에 중첩된 모듈이 있는 경우 다음과 같은 예기치 않은 동작이 나타날 수 있습니다:

  • 콘텐츠 편집기에서 이전에 편집할 수 있었던 모듈에 더 이상 액세스할 수 없습니다.
  • 콘텐츠 편집기에서 편집할 수 없는 예기치 않은 콘텐츠 렌더링 또는 누락된 콘텐츠.

기존 v1 사용자 정의 모듈을 v2로 업그레이드하기 전에 검토하여 코드에서 중첩된 모듈을 사전에 식별할 수 있습니다. 인라인 구문 또는 블록 구문을 사용하여 v1 사용자 정의 모듈에 중첩된 모듈이 추가되었을 수 있습니다.

인라인 구문


<div>My default content goes here</div>

블록 구문

{{ widget.my_awesome_field }}
{% widget_block rich_text "my_rich_text_nested_module" %}
{% widget_attribute "html" %}
<div>
My default content goes here
</div>
{% end_widget_attribute "html" %}
{% end_widget_block %}
 

이전에는 이러한 예제 중 하나를 사용하면 콘텐츠 편집기에서 왼쪽 사이드바에서 사용자 지정할 수 있는 편집 가능한 서식 있는 텍스트 모듈이 추가로 렌더링되었습니다.

v2 모듈 프레임워크에서는 중첩된 서식 있는 텍스트 모듈이 콘텐츠 편집기에 표시되지 않습니다.

템플릿의 중첩된 모듈은 더 이상 v2 모듈 프레임워크에서 편집할 수 없습니다. 이러한 모듈은 처음부터 다시 만들거나 원본 모듈의 복제 및 편집된 버전에서 다시 만들어 야 합니다.

참고:모듈에서 HubL 태그를 삭제하면 이 모듈을 참조하는 모든 게시된 페이지, 블로그 글 또는 이메일의 콘텐츠가 손실될 수 있습니다. 원래 중첩된 모듈이 v1 프레임워크에 남아 있고 업그레이드되지 않는 한 이미 게시된 이러한 모듈의 콘텐츠는 계속 예상대로 렌더링됩니다.

중첩된 모듈 교체하기

v1 중첩 모듈의 새 버전을 만들어 v2 모듈 프레임워크에서 사용하려는 경우 v1 모듈을 복제하고 복제본을 업그레이드할 수 있습니다. 이렇게 업그레이드된 복제된 모듈을 편집하여 모듈이 새 프레임워크에서 성공적으로 작동하도록 할 수 있습니다. 또는 모듈을 처음부터 다시 만들 수도 있습니다.

v1 모듈을 복제하고 v2로 업그레이드하려면 다음과 같이 하세요:

  • 마케팅 > 파일 및 템플릿 > 디자인 도구로 이동하여 파인더에서 모듈을 찾습니다.
참고: 모듈을 즉시 업그레이드할지 묻는 메시지가 표시될 수 있으므로 취소를 클릭하세요.
  • 복사하려는 모듈을 마우스 오른쪽 버튼으로 클릭하고 복제를 선택합니다.
  • 다시 모듈을 새 프레임워크로 업그레이드할지 묻는 메시지가 표시됩니다. 이 모듈을 사용하려는 템플릿 유형을 클릭하여 선택한 다음 업그레이드를 클릭합니다.
  • 중첩된 모듈의 HTML + HubL 마크업을 업데이트하여 HubL 태그의 인스턴스를 필드로전환합니다 .

v2 프레임워크에서 새 모듈을 만든 후에는 이 모듈에 사용하려는 템플릿을 복제하고 편집하여 향후 콘텐츠를 만들어야 합니다.

  • 찾기에서 v1 모듈을 사용하는 템플릿을 찾아 해당 템플릿의 복제본을 만듭니다.
  • 복제된 새 템플릿에서 v1 모듈을 마우스 오른쪽 버튼으로 클릭하고 모듈 교체를 선택합니다. 그런 다음 방금 만든 모듈의 새 v2 버전을 찾아 클릭합니다.
이 문서가 도움이 되었나요?
이 양식은 문서 피드백에만 사용됩니다. HubSpot으로 도움을 받는 방법 알아보기.