Magento 테마 개발 튜토리얼: 초보자를 위한 가이드

Author
TECHVIFY 팀은 기술과 혁신에 열정을 가진 경험 많은 전문가들로 구성되어 있습니다.
Magento 개발은 전자상거래 웹사이트를 만드는 데 있어 부인할 수 없이 중요한 역할을 합니다.
온라인 상점을 진정으로 업그레이드하려면, 기업은 Magento 테마 개발에 충분한 투자를 해야 합니다. 이는 웹사이트의 전체적인 외관, 분위기, 미적 요소를 디자인하는 데 결정적인 요소입니다.
TECHVIFY가 Magento 테마 개발을 위한 단계별 가이드를 소개합니다. 이 단계를 완전히 이해하면 전체 과정을 더 잘 파악할 수 있습니다.

더 알아보기: Top 7 Magento 개발 모범 사례
1단계: 테마를 포함하는 디렉토리 생성
- /app/design/frontend로 이동하여 테마 패키지에 사용할 공급업체 이름으로 새 디렉토리를 만듭니다: /app/design/frontend/
. - 공급업체 디렉토리 아래에 테마 이름에 따라 디렉토리를 생성합니다.
app/design/frontend/
├──
│ │ ├──…
│ │ │ ├── …
│ │ │ ├── …
이 구조를 만든 후에는 Magento가 테마가 존재함을 알 수 있도록 테마를 선언해야 합니다. Magento 백엔드에서 현재 테마로 설정할 수 있습니다.
2단계: 테마 선언
테마를 선언하려면 테마 이름이 포함된 theme.xml 파일을 생성해야 합니다. 테마가 상위 테마를 상속하는 경우 .xml 파일에 상위 테마 이름도 포함되어야 합니다. 필요 시 테마 미리보기 이미지도 필요합니다.
- 기존 theme.xml 파일을 추가하거나 복사하여 테마 디렉토리 app/design/frontend/
/ 에 넣습니다. - 다음 예시를 참고하여 구성합니다:
m2-theme
Magento/
media/m2-theme-image.jpg
theme.xml에서 테마 제목이나 상위 테마 정보를 변경한 후 테마가 이미 등록되어 있다면, 변경 사항을 데이터베이스에 저장하려면 Magento 관리자 페이지를 열거나 새로고침해야 합니다.
3단계: Composer 패키지 만들기
Magento 2 테마는 Composer 패키지로 배포되어 서버에 패키지로 등록됩니다. composer.json 파일을 추가하는 것은 선택 사항입니다.
composer.json 파일은 테마 의존성 정보를 제공합니다. 올바른 의존성과 버전은 현재 theme.xml 파일을 참조하세요.
테마 composer.json 파일 예시:
{
"name": "/m2-theme",
"description": "Magento 2 테마 커스터마이징",
"require": {
"php": "~5.6|~7.0|~7.1|~7.2|~7.3|~7.4",
"/m2-theme": "100.0.*",
"magento/framework": "100.0.*"
},
"type": "magento2-theme",
"version": "100.0.1",
"license": [
"OSL-3.0",
"AFL-3.0"
],
"autoload": {
"files": [
"Registration.php"
]
}
} 4단계: registration.php 추가
시스템에 테마를 등록하려면 테마 디렉토리에 registration.php 파일을 아래 내용으로 추가하세요:
/',
__DIR__
); 5단계: 정적 파일용 디렉토리 구조 생성
테마 패키지는 스타일, 폰트, JavaScript, 이미지 등 여러 유형의 파일로 구성됩니다. 각 유형은 테마 디렉토리 내 web 하위 디렉토리에 저장해야 합니다:
app/design//
├── web/
│ ├── css/
│ │ ├── source/
│ ├── fonts/
│ ├── images/
│ ├── js/
…/
6단계: 이미지 구성
테마에서 사용하는 상품 이미지 크기 및 기타 속성은 view.xml 구성 파일에서 설정합니다. 테마에 필수이며, 상위 테마에 존재하면 선택 사항입니다.
테마의 상품 이미지 크기가 상위 테마와 다르거나 상속하지 않는 경우 view.xml을 추가해야 합니다.
상위 테마의 etc. 디렉토리에서 view.xml 파일을 복사하거나 Blank 테마에서 복사합니다. view.xml 파일에서 모든 스토어프론트 상품 이미지 크기를 구성하세요.
250
250
7단계: 테마 로고 선언
Magento 애플리케이션에서 로고 이미지의 기본 형식과 이름은 logo.svg입니다. 다른 이름과 형식의 로고 파일을 사용할 수 있지만 선언이 필요할 수 있습니다.
테마 로고를 선언하려면 Magento_Theme/layout 디렉토리를 만들고 default.xml 파일에 다음 코드를 추가하세요. default.xml 파일 경로는 /app/design/frontend/
images/m2-logo.png
350
350
8단계: 테마 레이아웃 커스터마이징
기본 테마 구조가 생성되면 이제 레이아웃을 커스터마이징하거나 덮어쓰고 새 테마에 맞는 디자인 레이아웃을 설정할 수 있습니다.
테마 레이아웃을 덮어쓰려면 동일한 이름의 레이아웃 파일을 다음 위치에 넣어야 합니다: /app/design/frontend/Magento/
이 파일들은 다음 레이아웃을 덮어씁니다: /
9단계: Magento 관리자 패널에서 테마 구성
다음 단계는 Magento 관리자에서 생성한 커스텀 테마를 웹사이트에 적용하는 것입니다: 관리자->콘텐츠->디자인->구성
스토어 뷰에서 편집을 클릭하면 디자인 구성 페이지가 나타납니다. 기본 테마 탭에서 새로 만든 테마를 적용된 테마 드롭다운에서 선택하고 구성 저장을 클릭하여 테마를 적용합니다.
10단계: 최종 배포
테마를 Magento 스토어프론트에 표시하려면 다음 명령어를 실행하여 파일을 배포해야 합니다:
- Magento 스토어 SSH 계정에 로그인
- Magento 루트 디렉토리로 이동하여 아래 명령어 실행:
php bin/magento setup:upgrade- 테마 파일을 배포하기 위해 다음 명령어 실행:
php bin/magento setup:static-content:deploy이제 테마를 사용할 준비가 완료되었습니다.
이것이 Magento 테마 개발 과정에 대해 알아야 할 모든 것입니다. Magento 개발의 모든 최상의 기능을 활용하려면 절차를 세부적으로 숙지하세요.

이 과정이 너무 복잡하게 느껴진다면 신뢰할 수 있는 웹 개발 팀을 선택하는 것이 좋습니다. TECHVIFY Software는 Magento 개발 전문 업체로, 고객의 모든 요구사항을 충족하는 최고의 전자상거래 웹사이트를 만드는 것을 궁극적인 목표로 합니다. TECHVIFY와 함께라면 귀하의 온라인 상점이 안전한 손에 있음을 확신할 수 있습니다.
TECHVIFY – 글로벌 AI & 소프트웨어 솔루션 회사
스타트업부터 업계 리더까지: TECHVIFY는 단순한 결과물이 아닌 성과를 우선시합니다. 고성능 팀, AI(GenAI 포함) 소프트웨어 솔루션, ODC(오프쇼어 개발 센터) 서비스를 통해 시장 진입 시간을 단축하고 조기 ROI를 실현하세요.
