[지디넷코리아]많은 컨텐트가 포함되는 웹사이트의 개발자라면 지금까지 아래와 같은 기능을 지원하는 솔루션들을 여러개 봐왔을 것이다. 바로 컨텐트용 데이터베이스, 컨텐트에서
GUI를 분리하는 템플릿 시스템, 데이터베이스의 데이터를 관리하는 사용자 지향 인터페이스, 그리고 게제된 웹페이지의 외관을 통제하는 기능 등이 그것이다.
이 기사에서 소개할 야피(Yappi)는 이 중 상당히 흥미로운 제품이다.
야피는 데이터베이스에 저장된 컨텐트에 접근하는 자체 메쏘드를 제공하는
PHP 클래스다. 함께 번들된 관리 모듈은 데이터를 보다 쉽게 관리할 수 있도록 하며
API 자체도
CMS에 필요한 가장 일반적인 작업들을 수행하는데 모자람이 없다.
설치
야피를 설치하고 사용하려면 아파치와 같은 PHP 호환 웹서버와 PHP, 마이SQL 데이터베이스 서버가 필요하다. 야피를 다운로드받아 서버의 루트 아래에 압축을 푼다.
또한 야피 데이터 구조를 저장하기 위한 마이SQL 데이터베이스를 구축해야 한다. 소스 아카이브에서 yaapi.sql 파일을 사용해 데이터베이스를 만든 다음 클래스 컨스트럭터인 article.class.php 파일에서 야피 설정을 활성화해준다. 그리고 데이터베이스용 이름과 접근 파라미터도 함께 업데이트한다.
컨텐트 추가
데이터베이스에 컨텐트를 추가하려면 http://your-server/yaapi-root/admin/에 있는 야피 관리 모듈을 사용해야 한다. 야피를 설치한 서버이름으로 ‘your-server’를 대체하고 야피의 압축을 푼 디렉토리 경로명으로 ‘yappi-root’를 대체하라. 이 관리 모듈을 사용해 컨텐트 카테고리를 생성, 삭제하고 카테고리에 항목을 올릴 수 있다. 다음은 이런 과정에서 마주치게 될 필드들를 간단히 정리한 것이다.
- 카테고리 : 항목의 카테고리
- 섹션 ID : 기사에 2단계 계층구조가 있다면 이 파라미터로 두번째 레벨을 정의한다.
- 타이틀 : 항목의 제목
- 저자 : 항목의 저자
- 이메일 : 저자의 이메일 주소
- 승인 : 해당 항목이 표시될 수 있는 승인을 받았는지 여부를 담는 꼬리표
- 이미지 : 항목과 관련된 이미지 URL(옵션)
- 컨텐트 : 항목의 컨텐트
위 목록에 마지막으로 컨텐트에 대한 주의사항 하나를 덧붙인다. 야피는 아래에서 보는 것처럼 한정자(delimiter)를 사용해 큰 항목을 나눌 수 있다.
서문
#intro#
페이지 1 내용
#page#
페이지 2 내용
#page#
페이지 3 내용
#page#
기타 등등
| |
항목을 입력한 후 꼭 승인 절차를 거쳐야 한다. 승인된 항목만이 API를 통해 추출될 수 있다.
카테고리와 목록의 추출
데이터베이스에 컨텐트가 저장됐으면 API를 이용해 이를 추출, 표준 HTML 템플릿에 채울 수 있다. 템플릿은 사이트의 디자인에 맞게 변경할 수 있다. 아래에 있는 리스트 1에는 템플릿용 기본 코드가 나와 있다.
| |
<html>
<head>
<basefont face="Arial">
</head>
<body>
<table width="100%" cellspacing="0" cellpadding="5" align="CENTER" valign="TOP" height="450" border="1">
<tr>
<td colspan="3" width="100%" align="CENTER">
<p> </p>
<h1>Welcome to my site</h1>
<p> </p>
</td>
</tr>
<tr height="400">
<td width="25%" align="LEFT" valign="TOP"> Menu here</td>
<td width="50%" align="LEFT" valign="TOP"> Article List/Display here</td>
<td width="25%" align="LEFT" valign="TOP"> Ads here</td>
</tr>
</table>
</body>
</html> | |
 |
야피를 사용해 특정 카테고리 내의 모든 항목을 추출하고 중앙 블록에 제목, 저자와 서문을 표시할 수 있다. 리스트 2에 여기에 필요한 PHP 코드와 야피 API 호출이 나와 있다. 이 코드에 대한 추가 설명이 아래 시작된다.
| |
<?php
// accurately return the number of elements in an array
function number_of_elements($array) {
// initialize count variable to 0
$count = 0;
// check if the element passed is a valid array
if(is_array($array)) {
while (list($key, $value) = each($array)) {
if ($value) {
$count++;
}
}
}
return $count;
}
// include files
include("./article.class.php");
// initialize objects
$article = new article;
// the $id variable should always have a value
if(!isset($_GET["id"]) || $_GET["id"] == "") {
$category_id = 5; // set this to a default category id
} else {
$category_id = $_GET["id"];
}
?>
<html>
<head>
<basefont face="Arial">
</head>
<body>
<table width="100%" cellspacing="0" cellpadding="5" align="CENTER" valign="TOP" height="450" border="1">
<tr>
<td colspan="3" width="100%" align="CENTER">
<p> </p>
<h1>Welcome to My Site</h1>
<p> </p>
</td>
</tr>
<tr height="400">
<td width="25%" align="LEFT" valign="TOP">Menu comes here</td>
<td width="50%" align="LEFT" valign="TOP">
<?php
// get the articles for the selected category
$articles = $article->get_titles($category_id);
if(number_of_elements($articles) == 0) {
echo "Sorry, no articles in this category";
} else {
for ($count = 0; $count < number_of_elements($articles); $count++) {
// get the title, intro and author details for the article
$my_article = $article->get_article($articles[$count]['id']);
echo "<P><A HREF=\"article.php?id=".$articles[$count]['id']."\" >".$my_article->title."</A></P>";
echo "<P>by <A HREF=\"mailto:".$my_article->email."\" >".$my_article->author."</A> on ".$my_article->date."</P>";
echo "<P>".$my_article->content."</P>";
echo "<DIV ALIGN=\"CENTER\"><HR WIDTH=\"75%\" NOSHADE></DIV>";
}
}
?>
</td>
<td width="25%" align="LEFT" valign="TOP">Ads here</td>
</tr>
</table>
</body>
</html> | |
|
야피 사용의 첫 번째 단계는 클래스 오브젝트 사례를 만드는 것이다. 이 오브젝트는 데이터베이스의 컨텐트에 접근하기 위한 API 메쏘드와 속성을 보여준다. 항목의 타이틀 목록을 얻으려 한다면 카테고리 ID를 사용해야 한다. 이 ID는 URL을 통해 전달되거나 기본 값을 갖는다. get_titles() 메쏘드는 카테고리 ID를 사용해 해당 카테고리 내의 승인된 항목 ID와 제목을 반환한다.
get_article() 메쏘드는 좀 더 깊숙이 들어가 이전 단계에서 반환된 항목 ID의 목록을 다시 훑으며 각 항목을 대표하는 오브젝트를 반환한다. 제목, 저자의 상세정보, 서문이 이 오브젝트의 속성으로 노출되며 표준 표시법인 object->property로 추출될 수 있다.
항목의 제목은 object->linked를 이용해 항목 ID 순서대로 별도의 PHP 스크립트인 article.php에 연결된다는 점을 눈여겨 봐야 한다. 여기에 대해서는 아래에 더 언급한다.
이 웹페이지를 마무리지으려면 가용한 카테고리의 목록을 획득해 프린트하는 작업이 필요하다. 이 과정은 왼편에 위치한 메뉴에 필요하다는 점을 기억하라. 여기에는 카테고리 명과 각각의 ID를 포함한 연결된 배열을 반환하는 get_categories() 메쏘드가 사용된다. 리스트 3에는 리스트 2의 스크립트에 필수적인 최신 정보들이 담겨 있다.
| |
<?php
// accurately return the number of elements in an array
function number_of_elements($array) {
// initialize count variable to 0
$count = 0;
// check if the element passed is a valid array
if(is_array($array)) {
while (list($key, $value) = each($array)) {
if ($value) {
$count++;
}
}
}
return $count;
}
// include files
include("./article.class.php");
// initialize objects
$article = new article;
// the $id variable should always have a value
if(!isset($_GET["id"]) || $_GET["id"] == "") {
$category_id = 5; // set this to a default category id
} else {
$category_id = $_GET["id"];
}
?>
<html>
<head>
<basefont face="Arial">
</head>
<body>
<table width="100%" cellspacing="0" cellpadding="5" align="CENTER" valign="TOP" height="450" border="1">
<tr>
<td colspan="3" width="100%" align="CENTER">
<p> </p>
<h1>Welcome to My Site</h1>
<p> </p>
</td>
</tr>
<tr height="400">
<td width="25%" align="LEFT" valign="TOP">
<?php
// populate the categories menu
$categories = $article->get_categories();
for ($count = 0; $count < number_of_elements($categories); $count++) {
echo "<A HREF=\"category.php?id=".$categories[$count]['id']."\" >".$categories[$count]['name']."</A><BR CLEAR=\"all\"><BR>";
}
?>
</td>
<td width="50%" align="LEFT" valign="TOP">
<?php
// get the articles for the selected category
$articles = $article->get_titles($category_id);
if(number_of_elements($articles) == 0) {
echo "Sorry, no articles in this category";
} else {
for ($count = 0; $count < number_of_elements($articles); $count++) {
// get the title, intro and author details for the article
$my_article = $article->get_article($articles[$count]['id']);
echo "<P><A HREF=\"article.php?id=".$articles[$count]['id']."\" >".$my_article->title."</A></P>";
echo "<P>by <A HREF=\"mailto:".$my_article->email."\" >".$my_article->author."</A> on ".$my_article->date."</P>";
echo "<P>".$my_article->content."</P>";
echo "<DIV ALIGN=\"CENTER\"><HR WIDTH=\"75%\" NOSHADE></DIV>";
}
}
?>
</td>
<td width="25%" align="LEFT" valign="TOP">Ads here</td>
</tr>
</table>
</body>
</html> | |
|
아래 그림에서 이제 어떤 결과가 출력되는지 확인할 수 있다.
 |
| get_categories() 메쏘드를 사용한 출력 결과 |
항목의 컨텐트 추출
전체 항목은 항목 ID를 인자로 호출되는 article.php 스크립트에 의해 출력된다. 리스트 4는 이 스크립트용 코드를 담고 있다. 여기에는 페이지 아래의 페이지 번호 링크를 통해 항목의 각 페이지로 이동할 수 있도록 하는 페이지 한정자 지원이 포함돼 있다.
| |
<?php
// accurately return the number of elements in an array
function number_of_elements($array) {
// initialize count variable to 0
$count = 0;
// check if the element passed is a valid array
if(is_array($array)) {
while (list($key, $value) = each($array)) {
if ($value) {
$count++;
}
}
}
return $count;
}
// include file
include("./article.class.php");
// initialize objects
$article = new article;
// the $page variable should always have a value
if(!isset($_GET["page"]) || $_GET["page"] == "") {
$page = 1;
} else {
$page = $_GET["page"];
}
// the $article_id variable should always have a value
if(!isset($_GET["id"]) || $_GET["id"] == "") {
$article_id = 6;
} else {
$article_id = $_GET["id"];
}
?>
<html>
<head>
<basefont face="Arial">
</head>
<body>
<table width="100%" cellspacing="0" cellpadding="5" align="CENTER" valign="TOP" height="450" border="1">
<tr>
<td colspan="3" width="100%" align="CENTER">
<p> </p>
<h1>Welcome to My Site</h1>
<p> </p>
</td>
</tr>
<tr height="400">
<td width="25%" align="LEFT" valign="TOP">
<?php
// populate the categories menu
$categories = $article->get_categories();
for ($count = 0; $count < number_of_elements($categories); $count++) {
echo "<A HREF=\"category.php?id=".$categories[$count]['id']."\" >".$categories[$count]['name']."</a><br clear=\"all\"><br>";
}
?>
</td>
<td width="50%" align="LEFT" valign="TOP">
<table width="100%" border="0" cellspacing="0" cellpadding="5" valign="TOP">
<tr height="350" valign="TOP">
<td>
<?php
// get a page from the article
$article_data = $article->get_article($article_id, $page);
if(!is_object($article_data)) {
echo "Sorry, the article does not exist.";
} else {
echo "<p>".$article_data->title."</a></p>";
echo "<p>by <a href=\"mailto:".$article_data->email."\" >".$article_data->author."</a> on ".$article_data->date."</p>";
echo "<p>".$article_data->content."</p>";
}
?>
</td>
</tr>
<tr>
<td>
<?
echo "<P ALIGN=\"center\">";
// use the "for" loop to display the page numbers
// one-by-one
for($countpages = 1; $countpages <= $article_data->num_pages; $countpages++) {
if($countpages != $page) {
echo "<a href=\"".$php_self."?id=".$article_id."&page=".$countpages."\" class=\"".$style."\">".$countpages."</a>";
} else {
echo $countpages;
}
if($countpages != $article_data->num_pages) echo " | ";
}
echo "</p>";
?>
</td>
</tr>
</table>
</td>
<td width="25%" align="LEFT" valign="TOP"> Ads here</td>
</tr>
</table>
</body>
</html> | |
|
각 페이지의 컨텐트는 이전에 언급한 get_article() 메쏘드에 항목 ID와 페이지 번호를 넘겨주는 방법으로 추출할 수 있다. 유일한 차이점은 반환된 오브젝트의 ‘컨텐트’ 속성이 항목의 서문이 아닌 특정 페이지를 저장한다는 것이다.
num_pages() 속성은 항목내의 총 페이지 수를 얻는데 사용된다. 이 속성에 단순한 for() 루프를 결합하면 페이지 번호로 이뤄진 탐색 바를 만들 수도 있으며 다른 페이지 ID를 가졌지만 항목 ID가 똑같은, 동일한 스트립트로 각 페이지 번호를 하이퍼링크 시킬 수 있다.
다음 그림은 결과 화면의 예다. @
 |
| get_categories() 메쏘드를 사용한 출력 결과 |
로그인 |
회원가입 (뉴스레터신청) |
SITEMAP
관련기사
독자의견 남기기 (로그인 후 독자 의견을 남기실 수 있습니다.) 
