XE에서 워드프레스로 마이그레이션하기

XE에서 워드프레스로 마이그레이션(이전)하기

XE에서 워드프레스로 이전하는 작업을 주말 동안 진행했습니다.

다행히 Happist님의 도움으로 생각보다 수월하게 이전 작업을 완료할 수 있었습니다.

저는 이번 작업을 통해 다음 항목을 워드프레스로 옮겼습니다.

• 글(Post)
• 댓글
• 회원 리스트
• 조회수
• 카테고리
• 댓글
• 이미지(썸네일 생성)

본격적인 이전 작업을 하기 전에 먼저 phpMyAdmin에 접속하여 XE와 워드프레스 테이블을 비교, 분석하여 체계적인 계획을 세워서 진행하면 시행착오를 줄이고 시간을 절약할 수 있을 것입니다.

※ 2019년 12월 업데이트: 케이보드 게시판을 만든 코스모스팜에서 XE 마이그레이션 플러그인을 개발하여 출시했습니다. 플러그인을 사용하면 매우 수월하게 XE / 제로보드 게시판을 워드프레스 글(Post) 또는 케이보드 게시판으로 이전이 가능합니다.

• XE / 제로보드 게시판을 워드프레스로 쉽게 이전하는 방법

글 이전하기

글을 이전할 경우 XE의 xe_documents 테이블에 있는 컨텐츠를 워드프레스의 wp_posts 테이블로 복사하는 방식으로 진행했습니다. 이 두 테이블을 대강 비교해보면 다음과 같이 도표로 나타낼 수 있습니다.

처음에 xe_documents 테이블의 구조를 wp_posts와 동일하게 구성한 다음 테이블 이름을 바꾸는 방법을 채택했습니다(즉, xe_documents를 wp_posts로 이름 변경). 이 경우 이전은 되지만 예상치 못한 몇 가지 오류가 발생했습니다. 그래서 처음부터 다시 시작하여 xe_documents의 컨텐츠를 wp_posts로 복사하는 방법으로 진행하니 제대로 되었습니다.

XE 사이트의 글 URL 구조가 http://www.example.com/category/1234 식으로 되어 있었습니다. 워드프레스 사이트에서도 그대로 URL을 유지하도록 이전했습니다. 이 경우 301 리디렉션을 사용할 필요가 없습니다.

• 고유주소가 숫자로 된 경우 사이트 URL 형식 변경하기

특히 이전하려는 XE 사이트에 YouTube 동영상이 있는 카테고리가 있었는데, 이 카테고리 글에 포함된 YouTube는 글에 직접 삽입된 것이 아니라 다른 방법을 사용하여 추가된 것으로 보였습니다. XE를 사용해보지 않아서 정확한 내용은 모르겠지만, 사용자가 아마 별도의 필드에 YouTube 동영상 링크를 추가하면 본문에 YouTube가 표시되는 방식으로 작동하는 것으로 짐작되었습니다.

이 부분은 워드프레스에서 Advanced Custom Fields라는 플러그인을 사용하여 해결할 수 있었습니다.

글 슬러그가 깨지는 문제

글 ID를 글 slug에 복사하면 간단하지만, 글 슬러그에 글 제목이 표시되도록 하고 싶은 경우 글 제목을 글 slug에 복사해보면 인코딩이 맞지 않아서 글자가 깨집니다.

이 경우 다음과 같은 같은 코드를 만들어 테스트해보니 문제가 해결되었습니다.

add_action( 'the_post', 'wpse_94856_title_update' );

function wpse_94856_title_update( $post )
{
if ( empty ( $post->post_title ) )
return;

$temp_title = $post->post_title;
$new_title = urldecode($temp_title);
wp_update_post(
array (
'ID'         => $post->ID,
'post_name' => $new_title
)
);

// $post is passed by reference, so we update this property in real time
$post->post_name = $new_title;
}

글 목록이 새로고침되면 글 제목이 "XE에서 워드프레스로 마이그레이션하기!"이면 글 슬러그도 "XE에서 워드프레스로 마이그레이션하기!"와 같이 그대로 표시됩니다. 그런 다음 위 코드를 제거하고 목록을 새로 고침하면 "XE에서-워드프레스로-마이그레이션하기"처럼 제대로 글 slug가 업데이트됩니다. 중요한 것은 모든 글 목록을 한 번씩 로드해 주어야 위의 코드가 실행됩니다. (그럼 모든 글 목록을 한 페이지에 나열하는 코드를 하나 작성하면 되겠죠?)

* 주의: 위의 코드는 충분한 테스트를 거치지 않았기 때문에 예상치 못한 문제가 발생할 수 있습니다. 조건문을 post type으로 지정하면 더 좋은 결과를 얻을 것 같습니다.

이 문제를 Stackoverflow에 문의했는데 아무도 답변을 안 해주어서 포기하고 있었는데, 갑자기 방법이 생각이 나서 테스트해보니 잘 되네요.

썸네일 문제

이미지는 XE에 있는 것을 그대로 유지하고 썸네일(특성 이미지)을 새로 생성했습니다. 썸네일은 Happist님께 문의하여 글에 포함된 첫 번째 이미지를 특성 이미지(Featured Image)로 변환해주는 플러그인을 사용하는 방식을 택했습니다.

참고로 글 중에 src="./files/attach/images/..." 식으로 이미지가 추가되어 있는 글이 있을 수 있습니다. 이런 경우 가급적 전체 URL로 바꾼 후에 진행하면 더 좋은 결과를 얻을 수 있을 것 같습니다.

UPDATE wp_posts SET post_content = REPLACE(post_content, './files/attach/images', 'http://www.example.com/files/attach/images')

카테고리/태그 이전

XE 사이트의 글 URL 구조가 http://www.example.com/category/1234 식으로 되어 있었습니다. category 부분이 워드프레스에서 생각하는 카테고리와는 약간 차이가 있는 것처럼 보입니다. XE 사이트에서 대분류 > 소분류의 개념으로 되어 있는 것 같고, URL에는 소분류에 해당하는 슬러그가 표시되었습니다.

이 부분은 워드프레스로 이전했을 경우를 가정했을 때 어떻게 하는 것이 바람직할 지를 생각했습니다. 워드프레스의 고유주소 설정을 "카테고리/글ID" 형식으로 지정하면 본래 XE 사이트의 URL과 동일하게 된다는 점에 착안하여 카테고리는 XE에서 소분류에 해당하는 것만을 기준으로 이전했습니다.

카테고리와 태그는 워드프레스에서 다음 세 가지 테이블과 관련이 있습니다.

• wp_terms
• wp_term_relationships
• wp_term_taxonomy

자세한 내용은 WordPress Codex 문서를 참고하면 도움이 됩니다.

• WordPress Taxonomy (워드프레스 분류)

어떻게 XE의 카테고리와 매칭시킬까를 고민했습니다. 저는 xe_modules 테이블의 module_srl을 기준으로 하여 카테고리 데이터를 워드프레스로 복사했습니다.

태그는 xe_tags 테이블에서 tag_srl을 기준으로 삼았습니다. 조금 의외인 점은 동일한 태그에 대하여 tag_srl이 여러 개인 경우가 있어서 태그를 이전한 후에 동일한 태그에 대하여 slug가 달라지게 되었습니다.

중복되는 태그의 슬러그를 동일하게 바꾸고 싶다면 두 가지 작업을 해주면 될 것 같습니다(테스트는 하지 않았지만 별 문제 없이 될 것 같습니다).

• 동일한 태그를 가지는 중복된 tag_srl을 삭제합니다. 이 경우 가장 낮은 값을 유지하면 될 것입니다. 이 작업은 "Delete all Duplicate Rows except for One in MySQL?" 글에 소개된 SQL 쿼리를 응용하면 됩니다.
• 그런 다음 글에 포함된 중복되는 태그의 tag_srl을 비교하여 가장 낮은 tag_srl로 통일하도록 합니다. (만약 가장 낮은 tag_srl이 삭제되어 글에 나타나지 않는다면 문제가 발생할 것도 같습니다.)

회원 리스트 이전

회원 리스트의 경우 XE에서 일반 회원들이 글을 작성한 경우에 이전해주는 것이 좋을 듯 합니다. (그렇지 않으면 신규로 가입하는 회원에게 기존 회원의 ID가 부여되어 뜻하지 않게 신규 사용자가 기존 글의 작성자가 되는 문제가 발생할 것 같습니다.) 회원 정보를 이전시켜주더라도 문제는 usermeta 값을 설정하는 것은 엄두를 낼 수 없을 정도로 동일 사용자에 대하여 너무 많은 필드가 있기 때문에 모든 사용자에 대하여 '구독자' 역할을 부여하는 것에 만족해야 했습니다.

xe_member의 회원 정보를 wp_users 테이블로 복사한 후에 xe_member 테이블에 두 개의 컬럼(meta_key, meta_value)를 만든 후에 xe_member 테이블에서 다시 wp_usermeta 테이블로 복사하는 방식으로 모든 사용자에 대하여 '구독자' 역할을 부여했습니다.

UPDATE wp_usermeta SET meta_value = 'a:2:{s:10:"subscriber";b:1;s:15:"bbp_participant";b:1;}' where meta_value = 'a:1:{s:10:"subscriber";b:1;}'

추가 고려 사항

XE에서 게시판 형식으로 된 카테고리의 경우 워드프레스로 이전한 후에 List category posts와 같은 플러그인을 사용하여 리스트 형식으로 표시할 수 있습니다.

또는, 특정 카테고리의 템플릿 파일을 수정하여 게시판 형식으로 글을 표시하는 것도 가능합니다.

• 카테고리 글을 게시판 형식으로 나열하기

참고: XE의 특정 카테고리를 케이보드 게시판으로 이전하는 것도 가능합니다. 게시판으로 이전할 경우 비밀번호가 지정되어 있으면 XE 게시판의 비밀번호는 암호화되어 있어서 비밀번호는 그대로 이전이 되지 않습니다. 비밀번호는 임의로 지정하여 넣는 방법이나 핸드폰 번호나 이메일 주소로 대체할 수도 있을 것입니다. 이 작업은 위에서 설명한 것과는 다르게 진행되지만, 기본 원리는 동일합니다.

제로보드/XE 게시판에서 워드프레스 케이보드 게시판으로 이전하는 작업이 필요한 경우 여기에서 서비스(유료)를 의뢰하실 수 있습니다.

테스트 사이트 구성

저는 작업을 위해 테스트 사이트를 만들어서 진행했습니다. 당시 iPage라는 웹호스팅 업체를 이용했었는데, 데이터 용량이 많은 경우 패스트코멧이나 클라우드웨이즈와 같은 해외호스팅을 이용하는 것을 고려해볼 수 있습니다. 클라우드웨이즈의 경우 테스트 후에 서버를 삭제하면 사용한 기간에 해당하는 비용만 지불하면 됩니다.

용량인 크지 않은 경우 카페24와 같은 국내 호스팅을 이용하는 것도 가능합니다.

이전 후 카테고리/태그/댓글 개수가 제대로 표시되지 않는 경우

XE에서 워드프레스 이전하고 카테고리와 태그가 포함된 글 개수가 제대로 표시되지 않고 모두 "0"으로 표시되는 문제가 발생했습니다. 이 경우 다음 코드를 실행하면 카테고리/태그 개수가 올바르게 표시됩니다.

<?php
include("wp-config.php");
if (!mysql_connect(DB_HOST, DB_USER, DB_PASSWORD)) {  die('Could not connect: ' . mysql_error());  }
if (!mysql_select_db(DB_NAME)) {  die('Could not connect: ' . mysql_error());  }

$result = mysql_query("SELECT term_taxonomy_id FROM ".$table_prefix."term_taxonomy");
while ($row = mysql_fetch_array($result)) {
$term_taxonomy_id = $row['term_taxonomy_id'];
echo "term_taxonomy_id: ".$term_taxonomy_id." count = ";
$countresult = mysql_query("SELECT count(*) FROM ".$table_prefix."term_relationships WHERE term_taxonomy_id = '$term_taxonomy_id'");
$countarray = mysql_fetch_array($countresult);
$count = $countarray[0];
echo $count."<br />";
mysql_query("UPDATE ".$table_prefix."term_taxonomy SET count = '$count' WHERE term_taxonomy_id = '$term_taxonomy_id'");
}

$result = mysql_query("SELECT ID FROM ".$table_prefix."posts");
while ($row = mysql_fetch_array($result)) {
$post_id = $row['ID'];
echo "post_id: ".$post_id." count = ";
$countresult = mysql_query("SELECT count(*) FROM ".$table_prefix."comments WHERE comment_post_ID = '$post_id' AND comment_approved = 1");
$countarray = mysql_fetch_array($countresult);
$count = $countarray[0];
echo $count."<br />";
mysql_query("UPDATE ".$table_prefix."posts SET comment_count = '$count' WHERE ID = '$post_id'");
}
?>
출처: wpbeginner

스크립트를 실행한 후 삭제하도록 합니다.

마치며

이번 작업을 하면서 MySQL의 활용법에 대해 배울 수 있는 계기가 되었습니다. 책을 통해 익힌 내용을 실전에 적용하는 방법을 익힌 것이 큰 성과라면 성과라 할 수 있습니다. 또, 워드프레스 구조에 대해 조금 더 알 수 있는 기회가 된 것 같습니다.

추가

제로보드에서 워드프레스로 이전하려는 경우에는 제로보드에서 XE로 먼저 변환한 다음에 워드프레스로 이전을 시도하면 됩니다. 제로보드에서 XE로 바꾸는 방법은 구글 검색을 통해 쉽게 확인이 가능합니다.

아래 댓글에도 나와 있듯이 기본적으로 다음과 같은 프로세스를 따르게 됩니다.

1. export table data to SQL statements
2. if necessary, modify SQL statements to allow import
3. import modified SQL statements to new database
4. run table transformation (DDL) scripts on new database
5. append data in transformed table to existing table

마찬가지 방식으로 XE나 워드프레스의 특정 카테고리를 케이보드(Kboard) 게시판으로 이전이 가능합니다. 직접 이전을 실시해보면 몇 가지 고려해야 할 사항이 발생하는데, 그런 경우 SQL에 대해 조금 알면 도움이 될 것입니다.

DB 작업은 위험하기 때문에 반드시 백업을 실시한 다음에 진행하시기 바랍니다.

참고할 만한 사이트:

• https://www.postgresql.org/docs/current/static/index.html
• https://www.w3schools.com/sql/sql_default.asp

유용한 앱:

• https://play.google.com/store/apps/details?id=com.sololearn&hl=ko