ABOUT ME

-

Today
-
Yesterday
-
Total
-
  • 메타데이터 및 코드 삽입 플러그인 제작
    WordPress 2023. 12. 11. 17:00

    워드프레스 웹페이지에 메타데이터 및 코드를 삽입하는 플러그인을 만들 수 있습니다. 워드프레스 플러그인 개발은 PHP 프로그래밍 언어와 워드프레스의 API를 사용하여 이루어집니다. 메타데이터 및 코드 삽입 기능을 가진 플러그인을 만들기 위해서는 다음과 같은 단계를 따라야 합니다:

    An illustrative image depicting the process of creating a WordPress plugin for inserting metadata and code.
    An illustrative image depicting the process of creating a WordPress plugin for inserting metadata and code.

    개발 단계

    • 워드프레스 개발 환경 설정: 로컬 또는 원격 서버에 워드프레스 개발 환경을 설정합니다. 로컬 개발을 위해 MAMP, XAMPP, 또는 Local by Flywheel과 같은 도구를 사용할 수 있습니다.
    • 플러그인 기본 구조 생성: 워드프레스의 'wp-content/plugins' 디렉토리 안에 새로운 폴더를 생성하고, 플러그인의 기본 파일(예: my-plugin.php)을 만듭니다. 이 파일에는 플러그인의 헤더 정보와 기본 코드가 포함됩니다.
    • 훅(Hook)과 필터 사용: 워드프레스는 다양한 훅과 필터를 제공하여 플러그인이 워드프레스 코어 기능에 연동될 수 있도록 합니다. 예를 들어, wp_head 또는 wp_footer 훅을 사용하여 헤더나 푸터에 코드를 삽입할 수 있습니다.
    • 관리자 페이지 개발: 사용자가 메타데이터나 삽입할 코드를 입력할 수 있는 관리자 페이지를 개발합니다. 이를 위해 워드프레스의 설정 API를 사용할 수 있습니다.
    • 데이터 검증 및 저장: 사용자 입력 데이터의 검증과 저장을 위한 로직을 개발합니다. 보안을 위해 입력 데이터의 적절한 검증과 소독(sanitization)이 필수적입니다.
    • 테스트 및 디버깅: 개발한 플러그인을 다양한 환경에서 테스트하고 디버깅합니다. 이는 호환성과 안정성을 보장하기 위해 중요합니다.
    • 배포: 플러그인 개발이 완료되면, 워드프레스 공식 플러그인 디렉토리에 제출하거나, 자체적으로 배포할 수 있습니다.

     

    워드프레스 플러그인 개발에는 PHP, HTML, CSS, JavaScript 등의 웹 개발 지식이 필요합니다. 또한 워드프레스의 함수, 훅, 필터 등에 대한 이해도 필요합니다.

     

    처음부터 플러그인을 개발하는 것이 부담스러운 경우, 기존의 유사한 플러그인을 연구하거나, 온라인 튜토리얼이나 문서를 참고하는 것이 도움이 될 수 있습니다.

     

    과정

    워드프레스 플러그인을 만드는 과정을 단계별로 안내해 드리겠습니다. 여기서는 간단한 예시로 메타데이터 및 코드를 웹페이지의 헤더 또는 푸터에 삽입하는 기능을 가진 플러그인을 만드는 방법을 설명하겠습니다.

     

    1. 워드프레스 개발 환경 설정

    로컬 컴퓨터에 워드프레스 개발 환경을 설정합니다. MAMP, XAMPP, 또는 Local by Flywheel을 사용할 수 있습니다.

    Windows에서 MAMP (Macintosh, Apache, MySQL, PHP) 개발 환경을 설정하는 과정은 다음과 같습니다:

    MAMP 다운로드 및 설치:
    MAMP 웹사이트(공식 MAMP 다운로드 페이지)에 방문하여 Windows용 MAMP 버전을 다운로드합니다.
    다운로드한 설치 파일을 실행하여 설치 과정을 진행합니다. 설치 중 설정을 조정할 수 있지만, 대부분의 경우 기본 설정을 사용해도 충분합니다.

    MAMP 실행:
    설치가 완료되면 MAMP를 실행합니다.
    MAMP의 'Preferences'(환경 설정)를 통해 Apache, MySQL, PHP 등의 설정을 조정할 수 있습니다. 예를 들어, Apache의 포트를 변경하거나, PHP 버전을 선택할 수 있습니다.

    Apache 및 MySQL 서버 시작:
    MAMP의 메인 윈도우에서 'Start Servers'(서버 시작) 버튼을 클릭하여 Apache 웹 서버와 MySQL 데이터베이스 서버를 시작합니다.
    서버가 정상적으로 시작되면, 브라우저가 자동으로 열리며 MAMP 홈페이지가 표시됩니다. 이는 로컬 서버가 정상적으로 작동하고 있음을 나타냅니다.

    웹 페이지 및 데이터베이스 테스트:
    기본적으로 MAMP는 C:\MAMP\htdocs 폴더를 웹 서버의 루트 디렉토리로 사용합니다. 이 폴더 내에 PHP 파일을 생성하고 웹 브라우저에서 localhost로 접근하여 테스트할 수 있습니다.
    MySQL 데이터베이스는 MAMP의 MySQL 섹션에서 관리할 수 있으며, phpMyAdmin을 통해 데이터베이스를 쉽게 조작할 수 있습니다.

    환경 설정 조정:
    필요에 따라 PHP의 php.ini 파일이나 Apache의 httpd.conf 파일을 수정하여 추가적인 환경 설정을 할 수 있습니다. 이 파일들은 일반적으로 MAMP 설치 디렉토리 내에 위치합니다.

    개발 시작:
    이제 MAMP가 제대로 설정되었으므로, htdocs 디렉토리 내에서 웹 애플리케이션 개발을 시작할 수 있습니다.

    서버 중지:
    작업을 마친 후에는 MAMP 애플리케이션에서 'Stop Servers'(서버 중지) 버튼을 클릭하여 서버를 중지합니다.
    MAMP는 로컬 개발 환경을 빠르고 쉽게 구축할 수 있게 해주는 도구로, 특히 PHP 기반의 웹 애플리케이션 개발에 유용합니다.

     

    워드프레스 설치

    워드프레스를 설치하는 과정은 다음 단계로 나눌 수 있습니다:

    1) 웹 호스팅 및 도메인 준비:
    워드프레스를 설치하려면 웹 호스팅 계정과 도메인 이름이 필요합니다. 호스팅 서비스 제공업체에서 호스팅 계정을 구입하고, 원하는 도메인 이름을 등록합니다.

    2) 워드프레스 다운로드:
    워드프레스 공식 웹사이트(WordPress.org)에서 최신 버전의 워드프레스를 다운로드합니다.

    3) 워드프레스 파일 업로드:
    다운로드한 워드프레스 파일을 압축 해제합니다.
    FTP 클라이언트(예: FileZilla)를 사용하여 워드프레스 파일을 웹 서버의 루트 디렉토리(보통 public_html 또는 www)로 업로드합니다.

    4) 데이터베이스 생성:
    웹 호스팅 제어판(cPanel, Plesk 등)에 로그인합니다.
    데이터베이스 관리 섹션으로 이동하여 새 MySQL 데이터베이스를 생성합니다.
    데이터베이스 사용자를 생성하고, 이 사용자에게 생성한 데이터베이스에 대한 모든 권한을 부여합니다.

    5) 워드프레스 구성:
    웹 브라우저에서 도메인 이름을 입력하여 워드프레스 설치 페이지에 접근합니다.
    필요한 정보(데이터베이스 이름, 사용자 이름, 비밀번호, 데이터베이스 호스트, 테이블 접두어)를 입력합니다.
    'Submit'(제출) 버튼을 클릭하여 데이터베이스 설정을 완료합니다.

    6) 워드프레스 설치:
    워드프레스 설치 페이지가 표시되면 사이트 제목, 관리자 사용자 이름, 비밀번호, 이메일 주소를 입력합니다.
    'Install WordPress'(워드프레스 설치) 버튼을 클릭합니다.

    7) 설치 완료 및 로그인:
    설치가 완료되면 'Log In'(로그인) 버튼을 클릭하여 관리자 대시보드에 로그인합니다.

    8) 테마 및 플러그인 설정:
    워드프레스 대시보드에서 테마를 선택하고, 필요한 플러그인을 설치 및 활성화합니다.

    9) 컨텐츠 작성 및 사이트 설정:
    페이지, 게시글을 추가하고, 사이트의 외관을 커스터마이징합니다.
    이 단계들을 따라 워드프레스를 성공적으로 설치하고 구성할 수 있습니다. 

     

    추후(완성 단계) 웹호스팅 서버에 옮겨 놓는 과정에서 필요한 절차

    3번 단계인 '워드프레스 파일 업로드'는 다운로드한 워드프레스 설치 파일을 웹 호스팅 서버에 옮겨 놓는 과정을 의미합니다. 이 과정은 보통 FTP(File Transfer Protocol) 클라이언트를 사용하여 진행됩니다. 구체적인 단계는 다음과 같습니다:

    워드프레스 파일 압축 해제:
    워드프레스 공식 웹사이트에서 다운로드한 wordpress.zip 파일을 로컬 컴퓨터에서 압축 해제합니다. 압축을 해제하면 wordpress 폴더가 생성됩니다.

    FTP 클라이언트 사용:
    FTP 클라이언트 프로그램(예: FileZilla, WinSCP)을 사용합니다. 이 프로그램을 통해 로컬 컴퓨터의 파일을 웹 서버로 전송할 수 있습니다.

    웹 호스팅 서버에 접속:
    웹 호스팅 제공업체로부터 받은 FTP 접속 정보(호스트 이름, 사용자 이름, 비밀번호, 포트)를 사용하여 웹 호스팅 서버에 로그인합니다.

    워드프레스 파일 업로드:
    로컬 컴퓨터에서 wordpress 폴더를 찾습니다.
    웹 서버의 웹 루트 디렉토리(대개 public_html, www, 또는 htdocs 폴더)로 이동합니다.
    wordpress 폴더 내의 모든 파일과 폴더를 웹 서버의 웹 루트 디렉토리로 드래그 앤 드롭하여 업로드합니다.

    업로드 확인:
    파일 전송이 완료되면, 웹 브라우저에서 도메인 주소를 입력하여 워드프레스 설치 화면이 나타나는지 확인합니다.
    FTP 클라이언트를 사용하는 것이 처음이라면 다소 복잡하게 느껴질 수 있습니다. 그러나 이 과정은 파일을 서버로 전송하는 가장 일반적인 방법 중 하나이며, 몇 번 시도하다 보면 금방 익숙해질 것입니다. 

     

    FTP 클라이언트 사용

    FTP 클라이언트를 사용하는 방법에 대해 설명해 드리겠습니다. FTP(File Transfer Protocol) 클라이언트는 로컬 컴퓨터와 웹 서버 간에 파일을 전송하는 데 사용되는 프로그램입니다. 일반적으로 사용되는 FTP 클라이언트로는 FileZilla, WinSCP, Cyberduck 등이 있습니다. 여기서는 가장 널리 사용되는 FileZilla를 예로 들어 설명하겠습니다.

    FileZilla 설치:
    FileZilla 공식 웹사이트(https://filezilla-project.org/)에 방문하여 FileZilla 클라이언트를 다운로드하고 설치합니다.

    FTP 접속 정보 확인:
    웹 호스팅 서비스 제공업체로부터 FTP 접속 정보를 받습니다. 일반적으로 호스트(또는 서버) 주소, 사용자 이름, 비밀번호, 포트 번호가 포함됩니다.

    FileZilla 실행 및 서버 연결:
    FileZilla를 실행한 후, 상단 메뉴의 '파일' > '사이트 관리자'를 엽니다.
    '새 사이트' 버튼을 클릭하여 새 연결을 생성합니다.
    호스트, 포트, 사용자 이름, 비밀번호를 입력합니다. '로그온 유형'은 '일반'으로 설정합니다.
    '연결' 버튼을 클릭하여 웹 서버에 접속합니다.

    파일 및 폴더 전송:
    FileZilla 인터페이스 왼쪽에는 로컬 컴퓨터의 파일 시스템이, 오른쪽에는 웹 서버의 파일 시스템이 표시됩니다.
    로컬 시스템에서 업로드하고자 하는 파일이나 폴더를 찾습니다.
    웹 서버에서 파일을 업로드할 경로(예: public_html 또는 www 폴더)를 선택합니다.
    파일이나 폴더를 선택하고 오른쪽 창(서버)으로 드래그 앤 드롭하여 업로드합니다.

    업로드 확인 및 종료:
    파일 전송 상태는 FileZilla 하단의 '전송 대기열' 창에서 확인할 수 있습니다.
    전송이 완료되면, FileZilla에서 '서버' 메뉴를 통해 연결을 종료합니다.
    FTP 클라이언트 사용은 처음에는 다소 복잡해 보일 수 있지만, 몇 번의 시도로 익숙해질 수 있습니다. 보안을 위해 FTPS(FTP Secure) 또는 SFTP(SSH File Transfer Protocol)를 사용하는 것이 좋습니다. 이러한 방법은 기본 FTP보다 보안이 강화된 연결을 제공합니다.

     

    Hostinger에서 FTP 접속 정보를 확인 방법
    Hostinger에서 FTP 접속 정보를 확인하는 방법은 다음과 같습니다.

    Hostinger 계정에 로그인:
    먼저, Hostinger 웹사이트에 접속하여 로그인합니다. 이는 보통 Hostinger의 메인 페이지에서 할 수 있습니다.

    호스팅 계정 관리:
    로그인한 후, 대시보드 또는 제어판에서 관리하고자 하는 호스팅 계정을 선택합니다.

    FTP/파일 관리 섹션 접근:
    제어판에서 'FTP 계정' 또는 '파일 관리' 섹션을 찾아 클릭합니다. Hostinger에서는 이 부분이 직관적으로 표시되어 있을 것입니다.

    FTP 접속 정보 확인:
    FTP 계정 섹션에서, 이미 생성된 FTP 계정의 목록을 볼 수 있습니다. 여기에는 각 계정의 FTP 호스트, 사용자 이름 등의 정보가 포함되어 있습니다.
    만약 FTP 계정이 없다면, 새로운 FTP 계정을 생성할 수 있습니다. 이 경우, 사용자 이름, 비밀번호, 연결할 디렉토리 등의 정보를 입력하여 새 계정을 설정합니다.

    주요 FTP 접속 정보:
    FTP 호스트: 일반적으로 이는 ftp.yourdomain.com 형태이거나, Hostinger가 제공하는 서버 주소입니다.
    FTP 사용자 이름: FTP 계정의 사용자 이름입니다.
    비밀번호: 계정 생성 시 설정한 비밀번호입니다.
    포트: FTP 포트는 대개 21번입니다. SFTP(보다 안전한 연결)를 사용하는 경우 22번 포트를 사용할 수도 있습니다.

    보안 연결 사용:
    가능하면 SFTP(SSH File Transfer Protocol)를 사용하여 보다 안전한 파일 전송을 수행하는 것이 좋습니다. SFTP 설정 정보도 같은 섹션에서 확인할 수 있습니다.

    도움 및 지원:
    FTP 설정이나 접속에 어려움이 있는 경우, Hostinger의 고객 지원팀에 문의하거나 온라인 도움말을 참조하세요.
    Hostinger의 사용자 인터페이스는 직관적으로 설계되어 있어, 이러한 정보를 쉽게 찾고 관리할 수 있습니다. 

     

     

    2. 플러그인 기본 구조 생성

    워드프레스 설치 폴더 내의 wp-content/plugins 디렉토리 안에 새 폴더를 생성합니다. 예를 들어, my-custom-plugin이라는 이름을 사용할 수 있습니다.

    이 폴더 안에 my-custom-plugin.php라는 PHP 파일을 생성합니다.

     

    3. 플러그인 헤더 정보 작성

    my-custom-plugin.php 파일을 열고 다음과 같은 헤더 정보를 추가합니다:

    <?php
    /*
    
    Plugin Name: My Custom Plugin
    Description: A simple plugin to insert metadata and code in headers or footers.
    Version: 1.0
    Author: Your Name
    
    */

     

     

    4. 코드 삽입 기능 구현

    워드프레스 훅을 사용하여 헤더 또는 푸터에 코드를 삽입하는 함수를 작성합니다. 예를 들어, 다음은 헤더에 메타 태그를 추가하는 예시입니다:

    <?php
    /*
    
    Plugin Name: My Custom Plugin
    Description: A simple plugin to insert metadata and code in headers or footers.
    Version: 1.0
    Author: Your Name
    
    */
    
    function add_custom_meta_tags() {
        echo '<meta name="custom-meta" content="This is a custom meta tag.">';
    }
    add_action('wp_head', 'add_custom_meta_tags');

     

    5. 관리자 페이지 추가 (선택적)

    사용자가 플러그인 설정을 할 수 있는 관리자 페이지를 추가할 수 있습니다. 이를 통해 사용자가 직접 메타데이터나 코드를 입력할 수 있도록 할 수 있습니다.

    이 부분은 좀 더 복잡하며, 워드프레스 설정 API와 HTML/PHP 지식이 필요합니다.

    관리자 페이지 추가 
    워드프레스 플러그인에 관리자 페이지를 추가하는 과정은 다음 단계로 구성됩니다. 이 예제에서는 사용자가 메타데이터 또는 코드를 입력할 수 있는 간단한 폼을 생성하는 방법을 안내합니다.

    1) 관리자 메뉴 항목 추가
    add_menu_page 함수를 사용하여 워드프레스 관리자 메뉴에 새로운 페이지를 추가합니다.
    이 함수는 메뉴 페이지를 생성하고, 해당 페이지에 표시할 콘텐츠를 관리하는 콜백 함수를 지정합니다.

    function my_custom_plugin_menu() {
        add_menu_page(
            'Custom Plugin Settings', 
            'Custom Plugin', 
            'manage_options', 
            'my-custom-plugin', 
            'my_custom_plugin_settings_page', 
            'dashicons-admin-generic', 
            20
        );
    }
    add_action('admin_menu', 'my_custom_plugin_menu');


    2) 설정 페이지 구현

    콜백 함수 my_custom_plugin_settings_page 안에서 HTML 폼을 생성하여 사용자 입력을 받습니다.

    function my_custom_plugin_settings_page() {
        ?>
        <div class="wrap">
            <h2>My Custom Plugin Settings</h2>
            <form method="post" action="options.php">
                <?php
                settings_fields('my-custom-plugin-options');
                do_settings_sections('my-custom-plugin');
                submit_button();
                ?>
            </form>
        </div>
        <?php
    }​


    3) 설정 등록 및 섹션 추가

    register_setting 함수를 사용하여 사용자 입력을 데이터베이스에 저장할 설정을 등록합니다.

    add_settings_section 및 add_settings_field 함수를 사용하여 설정 페이지에 섹션과 입력 필드를 추가합니다.

    function my_custom_plugin_settings_init() {
        register_setting('my-custom-plugin-options', 'my_custom_plugin_settings');
    
        add_settings_section(
            'my_custom_plugin_settings_section', 
            'Custom Settings', 
            'my_custom_plugin_settings_section_cb', 
            'my-custom-plugin'
        );
    
        add_settings_field(
            'my_custom_plugin_setting_name', 
            'Setting Name', 
            'my_custom_plugin_setting_name_cb', 
            'my-custom-plugin', 
            'my_custom_plugin_settings_section'
        );
    }
    add_action('admin_init', 'my_custom_plugin_settings_init');

     

    4) 콜백 함수 구현

    각 섹션과 필드에 대한 콜백 함수를 구현합니다. 이 함수들은 설정 페이지에 표시될 내용을 결정합니다.

    function my_custom_plugin_settings_section_cb() {
        echo '<p>Enter your settings below:</p>';
    }
    
    function my_custom_plugin_setting_name_cb() {
        $options = get_option('my_custom_plugin_settings');
        ?>
        <input type="text" name="my_custom_plugin_settings[setting_name]" value="<?php echo $options['setting_name']; ?>">
        <?php
    }

     

    5) 사용자 입력 처리

    사용자가 폼을 제출하면, register_setting에 의해 입력 값이 자동으로 저장됩니다.

    get_option 함수를 사용하여 저장된 설정 값을 플러그인의 다른 부분에서 사용할 수 있습니다.


    이러한 단계를 통해 워드프레스 플러그인에 간단한 관리자 설정 페이지를 추가할 수 있습니다. 이 예제는 기본적인 구조를 제공하며, 필요에 따라 추가적인 입력 필드, 유효성 검사, 사용자 인터페이스 요소 등을 포함시킬 수 있습니다. 워드프레스 개발에 익숙하지 않다면, 공식 문서나 관련 튜토리얼을 참고하는 것이 도움이 됩니다.

     

    6. 테스트 및 디버깅

    로컬 개발 환경에서 플러그인을 활성화하고 테스트합니다.

    다양한 테마와 다른 플러그인과의 호환성을 확인합니다.

     

    7. 배포

    개발이 완료되면, 워드프레스 공식 플러그인 디렉토리에 제출하거나, 자체적으로 배포할 수 있습니다.

     

    이 기본적인 안내는 단순한 플러그인 개발을 위한 것입니다. 보다 복잡한 기능을 구현하려면 추가적인 PHP, HTML, CSS, JavaScript 지식이 필요하며, 워드프레스 코어 함수와 훅에 대한 이해가 필요합니다. 워드프레스 공식 문서나 온라인 튜토리얼을 참고하면 더 많은 정보와 예제를 찾을 수 있습니다.

     

     

     

Designed by Tistory.