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

10

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

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

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

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

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

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

글 이전하기

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

XE와 워드프레스 테이블 비교

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

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

특히 이전하려는 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 문서를 참고하면 도움이 됩니다.

어떻게 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 게시판에서 워드프레스 케이보드 게시판으로 이전하는 작업이 필요한 경우 여기에서 서비스(유료)를 의뢰하실 수 있습니다.

테스트 사이트 구성

저는 테스트 사이트를 구성하여 테스트 사이트에서 이전 테스트를 하고 완료한 후에 본래 사이트에 이전시켰습니다. 문제는 데이터 용량이 5GB가 넘어가서 테스트 사이트를 구성하느라 애를 먹었습니다. 파일을 다운로드받는 데 6시간이 걸렸고, 이것을 테스트 사이트에 올리는 데 또 그 정도의 소요되어 테스트 사이트를 준비하는 데 하루가 걸렸습니다.ㅎㅎ

그리고 DB의 크기도 150MB가 넘어가서 phpMyAdmin을 통해 Import하느라 조금 시간이 걸렸습니다. 데이터 용량이 워낙 크기 때문에 무제한 공간과 트래픽을 제공하는 iPage의 공유 호스팅을 사용했습니다. 공유 호스팅이라 SSH를 지원하지 않습니다. 처음에 DB를 분할하여 Import하는 데 40분 이상이 걸렸습니다. 중간에 모두 갈아엎고 새롭게 시도하기로 하고 DB를 모두 삭제하고 다시 Import해야 하는 상황이 발생했습니다. 시간이 제법 걸리기 때문에 시간을 절약하기 위해 DB를 FTP에 올려놓고 iPage에 연락하여 DB를 Import해 달라고 요청했습니다. 친절하게도 DB를 임포트해 주었지만 실제로 살펴보니 일부 테이블이 누락되어 있었습니다. (역시 공짜는 없는가 봅니다.ㅠㅠ) 그래서 어쩔 수 없이 수동으로 phpMyAdmin에 가져오기(Import)하여 테스트를 실시했습니다.

다만 아쉬운 점은 테스트 사이트에서 이전을 완료한 후에 실제 사이트로 DB를 옮기는 과정에서 조금 애를 먹었습니다. 실제 사이트가 카페24에서 호스팅되고 있었는데, DB 업로드 용량이 21MB 정도네요. 이 설정을 높여보려고 노력했지만 잘 안 되어 DB를 분할하여 이전을 시도했습니다. 하지만 이상한 오류가 나면서 실패했습니다. 어쩔 수 없이 테이블별로 나누어서 이전을 하는 바람에 시간이 제법 걸렸습니다. 또, 조회수가 저장된 테이블은 오류가 발생하여, 그 부분은 나머지 테이블을 옮긴 후에 해당 글 카운터 플러그인을 설치하고 다시 데이터를 이전하는 과정을 실시했습니다.

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

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 작업은 위험하기 때문에 반드시 백업을 실시한 다음에 진행하시기 바랍니다.

참고할 만한 사이트:

유용한 앱:

*일부 글에 제휴링크가 포함될 수 있습니다.기부를 통해 블로그 운영을 후원하실 수 있습니다.

Related Posts

댓글 10건
  1. 오정민

    금일 XE쇼핑몰에서 워드프레스 쇼핑몰로 회원 DB와 게시판DB를 이전하는 유료지원 문의를 드렸습니다. 확인부탁드립니다. : )

  2. HB

    안녕하세요. 제로보드 마이그레이션과 관련하여 얼마 전에 구글 양식으로 문의를 드렸는데, 혹시 받지 못하셨는지요?

    1. Word

      안녕하세요?

      언제쯤 문의 양식을 제출하셨는지 알려주시겠어요?
      (스팸을 비롯하여) 메일이 워낙 많이 들어와서 간혹 놓치는 경우가 있습니다.

      1. HB

        저도 잊고 있었습니다. ㅎㅎ 좀전에 다시 문의드렸습니다! 확인 부탁드릴게요.

  3. Word

    참고로 제로보드를 워드프레스로 이전하려는 경우 이와 관련된 글이 인터넷에서 검색되지만 너무 오래되어 확인은 할 수 없네요.

    제로보드의 경우 다음과 같은 방법으로 시도해볼 수 있습니다.

    1. 제로보드 -> XE로 마이그레이션 – 이와 관련하여 다양한 글이 검색되니 참고하시면 됩니다(예; http://m.blog.naver.com/punk1003/30114220952 )

    2. XE -> 워드프레스로 마이그레이션

    즉, 제로보드 -> XE -> 워드프레스로 이전시키면 보다 수월해집니다. XE에서 워드프레스로 이전시키는 플러그인이 있는 것 같지만 너무 오래되어서 제대로 작동하는지 모르겠습니다. 또 글 ID가 달라지거나 일부 글이 누락되는 문제가 발생하는 것 같습니다.

  4. Happist

    멋지십니다. 짝짝짝
    1년전에 이 글을 봤으면 고생을 덜 했을텐데라는 생각이 절로 들었습니다.
    다른 분들께 진짜 좋은 정보가 될 것 같습니다.

    1. Word

      감사합니다~

      Happist님 글이 방향을 잡는 데 많은 도움이 되었습니다^^

  5. 이카루스

    몇년전 XE를 할때 워드프레스로 옮기는 방법이 있나 싶어서 XE를 아무리 해 봐도 시원한 답볍을 못 찾았어요..
    제일 간단한 방법은 XE에도 블로그 툴이 있어서 이리로 모두 다 옮긴 다음에 워드프레스로 이전 하라는 글을 본 것 같은데 이런 고수적인 방법이 있었군요..
    저는 읽어봐도 생소할 따름입니다..

    1. Word

      작년에 워드프레스가 아닌 게시판 글을 워드프레스 게시판 플러그인인 케이보드로 이전해야 할 일이 있어서 많이 연구하고 해외 커뮤니티에 묻기도 했습니다. 하지만 당시로서는 어떻게 해야 할지 엄두를 내지 못하겠더군요. 어느 정도 이 쪽에 대한 지식이 있어야 내용이 파악이 되는 것 같습니다.

  6. Word

    참고할 만한 사이트:

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

    참고:
    While SQL is somewhat standardized, databases and database operations are not so we need to know the specific databases you’re working with. That said, most RDBMS databases have CLI tools to export one or more tables reasonably efficiently as well as CLI tools to import. Then it’s a matter of translating possible incompatibilities of the output to what’s needed for the input.

    In general, the process is this:

    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

    For most RDBMS, you can also choose other export&import formats, like CSV. If you provide the details of both the databases, you’ll get more specific help.

    For example, for two MySQL databases, you can do the following:

    mysqldump -u username -p databaseName tableName > tableName.sql

    Similarly, to import this data to a MySQL database:

    mysql -u username -p -D databaseName < tableName.sql

    If the databases are compatible, then no transformations are needed (step 2). To modify the newly imported table, you can do:

    mysql -u username -p -D databaseName < tableNameDDL.sql
    tableNameDDL.sql:

    ALTER TABLE tableName ADD myNewColumn VARCHAR(60);

    To append the data in tableName to your existing table, you can do:

    mysql -u username -p -D databaseName < tableNameAppend.sql
    tableNameAppend.sql

    INSERT INTO existingTableName (c1, c2, c3 )
    SELECT c1, c2, c3 FROM tableName;

    You could do your transformations in the old database as well of course with an initial copy of the data into your temporary table prior to export.

댓글 남기기