Kurogo Tutorial 05 - 모듈 생성하기 -

Making Your First Module - Hello World

이 섹션에서는 모듈 생성 과정에 대한 overview를 보여 드릴 겁니다. 그냥 따라하시기만 하시면 됩니다. 좀 더 자세한 테크닉을 원하시면 Creating a new module  를 보세요.이 섹션에서 설명된 대부분의 내용은 좀 더 자세한 설명들이 Documentation 안에있습니다.

 

Case Sensitivity

일단 대소문자 구분을 한다는 것을 명심해 두세요. 많은 개발자들이 대소문자 구분을 하지 않는 파일 시스템을 사용하고 있습니다. 대부분의 서버들 특히 리눅스 베이스 서버들은 대소문자를 구분하는 파일 시스템을 사용하고 있습니다. 그렇기 때문에 폴더 위치나 url을 사용할 때 이 규칙을 따르는 것은 매우 중요합니다. 웬만하면 폴더나 url들은 소문자를 사용하시면 좋습니다.

Creating the module folder structure

Note:  installation steps 을 따라서 설치하고 site folder도 생성한 상태여야 합니다. SITE_DIR 은  site/YOURSITE 로 돼 있어야 합니다. YOURSITE는 여러분이 생성한 사이트의 이름입니다.

Kurogo 프레임워크는 다양한 위치에 모듈 데이터를 생성할 수 있습니다. (see Source code tour) 일단 여러분의 모듈들을 여러분 사이트의 app/modules folder에 생성하세요. Kurogo 모듈로서 이미 사용되고 있는 폴더를 /app/modules 에 넣지 마세요.

 

• SITE_DIR/app/modules에 hello 라는 폴더를 만드세요. 
• SITE_DIR/app/modules/hello folder 안에templates 라는 폴더를 만드세요.
• 
  

Creating the module class file

hello directory 안에 HelloWebModule.php 라는 파일을 만드세요. 그리고 아래 내용을 그 파일안에 작성하세요.

<?php

class HelloWebModule extends WebModule
{
  protected $id='hello';
  protected function initializeForPage() {
    $this->assign('message', 'Hello World!');
  }
}

Creating the template file

hello/templates directory 안에 index.tpl 라는 파일을 만들고 아래 내용을 넣으세요. 

{include file="findInclude:common/templates/header.tpl"}

<h1 class="focal">{$message}</h1>

{include file="findInclude:common/templates/footer.tpl"}

이제 폴더 구조가 아래처럼 됐을 겁니다.

Creating the nav bar image

56 x 56 PNG file 을 만들고 title-hello.png 라고 이름을 넣어 주세요. 그리고 이 이미지 파일을 아래 폴더에 넣어주세요.  SITE_FOLDER/themes/default/common/images/compliant.

Creating the config folder

이 모듈을 로드하기 위해 configuration 폴더가 필요합니다.

• SITE_FOLDER/config 안에 hello 폴더를 생성하세요
• SITE_FOLDER/config/hello/module.ini 파일을 생성하시고 아래와 같이 내용을 넣으세요. 

[module]
title="Hello"
disabled = 0
protected = 0
search = 0
secure = 0

Viewing the module

여기까지만 하면 여러분의 웹 브라우저에서 여러분의 새로운 모듈을 보실 수 있을 겁니다. 여러분 사이트가 8888이라고 가정하고 여러분의 컴퓨터의 브라우저에 http://localhost:8888/hello 를 넣으세요. 성공했다면 아래와 같은 화면을 보실 수 있을 겁니다.

 

축하드립니다. 방금 아주 간단한 모듈을 직접 만드셨습니다.