CMS 모듈 통합 및 조정

튜토리얼의 전제 조건 및 목표

이 튜토리얼을 위해서는 bluetronix CMS에 대한 개발자 접근 권한이 필요합니다. 개발자 폴더가 어떻게 작동하는지와 시스템 폴더에 있는 파일이 _own으로 표시되는 이유를 이미 알고 있어야 합니다.

우리는 기존의 뉴스 - 블로그 모듈을 예제로 사용합니다. 모듈을 활성화하고, 목록 보기를 CMS 페이지에 통합한 다음, 이후에 자체 모듈 파일과 구성을 조정합니다. 원본 파일은 변경되지 않습니다.

1. 블로그 모듈 활성화

CMS에서 모듈을 열고 뉴스 - 블로그를 선택하십시오.

블로그 모듈 활성화 옵션을 활성화하고 OK로 보안 질문을 확인하십시오.

이후에는 모듈 구성 도구를 사용할 수 있습니다. 왼쪽에는 기술적 설정이, 오른쪽에는 언어 종속 모듈 텍스트가 위치합니다.

2. CMS 페이지에 블로그 목록 삽입

페이지 /Blog/index.html를 열고 HTML 코드를 선택하십시오. 블로그 페이지는 짧은 CMS 태그를 통해 통합됩니다.

<!--bx_Mod/Blog/Modul-Blog-List-->

이 태그는 블로그 모듈과 그 목록 보기를 참조합니다. CMS는 렌더링할 때 이 위치에 모듈로 생성된 출력을 삽입합니다.

3. 파일 관리자에서 중앙 모듈 파일 열기

모듈의 실제 PHP 및 HTML 로직은 페이지 HTML에 직접 있지 않으며 중앙 시스템 폴더 bx_Mod에 있습니다. 먼저 파일 관리자에서 이 폴더를 열고, 그 다음 블로그 하위 폴더를 엽니다.

블로그 폴더에는 모듈-블로그-목록.php, 모듈-블로그-쇼케이스.php, config.php, 기타 모듈 파일 및 languages 하위 폴더가 포함되어 있습니다.

4. 블로그 목록의 기본 파일 보기

모듈-Blog-List.php를 선택하고 편집을 통해 엽니다.

기본 파일에는 리스트 뷰를 위한 프로그램 논리가 포함되어 있습니다. 보여진 코드에서는 모듈 구성과, 존재하는 경우 프로젝트별 config_own.php가 포함됩니다.

이를 통해 하나의 모듈 포함이 다양한 페이지에서 동일한 중앙 프로그램 논리를 사용할 수 있습니다. 기본 모듈을 사용하는 프로젝트의 경우, 나중에 CMS 업데이트가 이 파일에 대한 변경 사항을 제공할 수 있습니다.

원래 모듈-Blog-List.php를 직접 수정하지 마십시오. 이 파일은 시스템에 속하며 CMS 업데이트 시 덮어씌워질 수 있습니다.

5. _own으로 자체 목록 보기 만들기

출력을 직접 변경하려면 기본 파일을 복사합니다. 자신의 복사는 정확히 적합한 _own 식별을 받습니다:

Modul-Blog-List.php
        ↓ kopieren
Modul-Blog-List_own.php

새 파일 모듈-Blog-List_own.php를 엽니다. 이 프로젝트별 버전에서는 PHP 논리와 HTML 출력을 변경할 수 있으며, 기본 파일에는 손을 대지 않습니다.

우리의 테스트에서는 제목에 잘 보이는 문자열 NEW!!!!를 추가합니다. 나머지 리스트 뷰는 그대로 유지됩니다.

자신의 모듈 파일을 저장하고 블로그 페이지를 다시 로드합니다. CMS는 적합한 _own 변형을 사용하며, /Blog/index.html의 자리 표시자는 변경되지 않습니다. 변경된 제목 NEW!!!! 최신 기사로 활성화된 자신의 파일을 식별할 수 있습니다.

6. 모듈 설정 및 자체 구성

HTML 출력 외에도 모듈의 구성을 변경할 수 있습니다. 스크린샷에서는 예를 들어 모듈-Blog-ShowCase의 경우 DS Repeats = 3 값을 보여줍니다.

값을 2로 변경하고 설정을 저장하십시오. 이를 통해 이 ShowCase 영역에 원하는 개수를 설정할 수 있습니다. 이 설정은 모듈-Blog-ShowCase에 적용되며 블로그 리스트 뷰의 모든 기사 개수와 자동으로 동일하지 않습니다.

자신의 구성은 bx_Mod/Blog/config_own.php에 있습니다. 파일 관리자에서 이 파일을 선택하세요.

보여진 config_own.php는 관련 모듈 영역 모듈-Blog-ShowCase가 로드될 때만 값을 목표로 덮어씌웁니다:

if($ModulNameGB == "Modul-Blog-ShowCase") {
   $CF_DS_Repeats = 2;
}

기본 값은 여전히 config.php에서 옵니다. 따라서 별도의 구성 파일이 모든 기본 값을 반복할 필요는 없으며, 오히려 원하는 차이점만 포함할 수 있습니다.

7. 데이터베이스 테이블 및 모듈 페이지 정하기

기본 구성 bx_Mod/Blog/config.php에서는 사용된 데이터베이스 테이블과 상세 및 리스트 보기의 경로를 포함하고 있습니다. 보여진 예에서는 값이 다음과 같습니다:

$CF_DatabaseTable = "Blog";

$CF_DetailPage = "/Blog/Detail.html";
$CF_ListPage = "/Blog/index.html";

블로그 모듈을 기반으로 다른 목적으로 자신만의 변형을 개발할 경우 자신만의 구성에서 다른 데이터베이스 테이블을 보관할 수 있습니다. 이때 새 테이블이 모듈 파일에서 예상하는 필드를 포함하고 리스트 및 상세 페이지가 새 변형에 적합한지 확인하십시오.

8. 모듈의 언어 파일

bx_Mod/Blog/languages에서 블로그 모듈의 언어 파일이 있습니다. 사용 가능한 언어마다 별도의 PHP 파일이 있으며, 예를 들어 de.php, en.php 및 fr.php가 있습니다.

여기에서 언어 종속 모듈 텍스트가 관리됩니다. 프로젝트 별 변경을 위해 원본 언어 파일을 직접 덮어쓰는 대신 모듈 버전에서 지원하는 자신의 파일 형식을 사용하십시오.

9. 기본 모듈과 자체 버전 구분하기

_own 규칙은 정기 업데이트를 통해 귀하의 맞춤형 변경이 덮어씌워지는 것을 방지합니다. 동시에 이러한 개별 버전의 유지 관리는 귀하의 책임입니다. 이후 CMS 업데이트에서 기본 파일의 중요한 변경 사항이 귀하의 파일에 영향을 미치는지 확인하십시오.

10. 요약

블로그 모듈은 모듈 → 뉴스 - 블로그에서 활성화하고, 리스트 뷰를 CMS 마크업을 통해 포함시키며, 실제 프로그램 논리는 bx_Mod/Blog에서 중앙 관리합니다. 자신의 변경 사항이 필요하면 모듈-Blog-List.php를 모듈-Blog-List_own.php로 복사하십시오. 기본에서 벗어난 설정은 필요에 따라 config_own.php에 저장하십시오.

CMS-Seite /Blog/index.html
        ↓ Modul-Markierung
bx_Mod/Blog/Modul-Blog-List.php
        ↓ passende _own-Datei vorhanden?
Modul-Blog-List_own.php
        ↓ Konfiguration und Datenbank
HTML-Ausgabe innerhalb der CMS-Seite

이 방법으로 기존 모듈을 원래 시스템 파일을 변경하지 않고도 특정하게 확장할 수 있습니다.