Đường dẫn thư mục plugin wordpress ở đâu?

Trong đoạn mã này, chúng tôi sẽ xem xét cách bạn có được đường dẫn đầy đủ của tệp plugin. Khi bạn đang phát triển một plugin, bạn có thể lưu trữ nhiều loại tệp trong đó, chẳng hạn như tệp CSS hoặc JS nơi bạn cần truy cập URL đầy đủ của tệp hoặc bạn có thể có một tệp PHP khác mà bạn muốn đưa vào bằng cách gọi đường dẫn thư mục đầy đủ. Vì thư mục plugin nằm trong thư mục wp-content nên đường dẫn đến thư mục có thể khá lớn

http://example.com/wp-content/plugin-name/plugin/frontend/css/css-file.css

Trên đây là những gì bạn sẽ phải sử dụng để đưa biểu định kiểu vào ứng dụng của mình từ plugin. Nếu bạn đang gọi nó từ một tệp bên trong thư mục giao diện người dùng, bạn sẽ sử dụng đoạn mã sau

function plugin_styles() {
    wp_enqueue_style( 'css-styles', 'http://example.com/wp-content/plugin-name/plugin/frontend/css/css-file.css' );
}
add_action( 'wp_enqueue_scripts', 'plugin_styles' );

Vấn đề chúng tôi gặp phải khi xây dựng một plugin WordPress là bạn phải cho rằng plugin này có thể được sử dụng trên bất kỳ trang web nào trên bất kỳ cài đặt WordPress nào. Bởi vì nó có thể được sử dụng trên bất kỳ trang web nào nên bạn không thể đưa tên miền của mình vào bên trong hàm wp_enqueue_style. Vì một trang web WordPress có thể thay đổi vị trí của thư mục wp-content bằng hằng số wp-config, bạn không thể cho rằng wp-content nằm ngoài thư mục gốc của tên miền. Để bao gồm điều này một cách chính xác từ một tệp bên trong thư mục giao diện người dùng, bạn nên sử dụng chức năng plugin_dir_url() của WordPress, chức năng này sẽ trả về URL đầy đủ của thư mục hiện tại

function plugin_styles() {
    wp_enqueue_style( 'css-styles', plugin_dir_url( __FILE__ ) . 'css/css-file.css' );
}
add_action( 'wp_enqueue_scripts', 'plugin_styles' );

Nhưng điều gì sẽ xảy ra nếu bạn không muốn URL cho thư mục mà muốn có đường dẫn tệp đầy đủ để bạn có thể bao gồm tệp PHP mới thay vì thực hiện các thao tác sau

include_once '/home/user/var/www/vhost/website/wp-content/plugin-name/plugin/frontend/new-file.php';

Bạn có thể sử dụng chức năng WordPress của plugin_dir_path() để lấy đường dẫn đầy đủ của thư mục

include_once plugin_dir_path( __FILE__ ) . 'new-file.php';

Bạn cũng có thể sử dụng chức năng này để bao gồm tất cả các tệp trong một thư mục bằng cách sử dụng chức năng PHP toàn cầu

Đóng góp các plugin hữu ích cho thư mục chỉ là một trong những cách bạn có thể trả lại cho cộng đồng WordPress

Trong bài viết này, chúng tôi sẽ thảo luận về lợi ích của việc thêm plugin của bạn vào Thư mục plugin WordPress cùng với hướng dẫn từng bước về cách thêm plugin của bạn vào kho lưu trữ

Tại sao Thêm Plugin của bạn vào Thư mục Plugin WordPress?

Nếu bạn đã tạo một plugin WordPress mà bạn nghĩ sẽ hữu ích cho người khác, thì bạn nên cân nhắc thêm nó vào Danh mục plugin WordPress chính thức. Điều này có rất nhiều lợi ích cho bạn với tư cách là nhà phát triển

Thư mục plugin WordPress là nơi đầu tiên mà nhiều người dùng tìm đến khi tìm kiếm plugin cho trang web WordPress của họ. Việc thêm plugin của bạn vào thư mục sẽ giúp người dùng dễ dàng tìm thấy hơn và mang lại cho bạn sự tín nhiệm cao hơn với tư cách là nhà phát triển

Bạn sẽ không phải trả tiền cho băng thông cần thiết để tải xuống plugin của mình và thư mục sẽ tự động theo dõi xem có bao nhiêu người đã tải xuống và sẽ thông báo cho họ khi có bản nâng cấp

Thư mục cũng sẽ giúp bạn hỗ trợ plugin. Người dùng có thể xếp hạng plugin của bạn, để lại phản hồi và báo cáo lỗi cũng như sử dụng diễn đàn hỗ trợ

Tất nhiên, cũng có một số yêu cầu và hạn chế. Đầu tiên là plugin của bạn phải có giấy phép tương thích với WordPress. GPLv2 trở lên được khuyến nghị

Ngoài ra còn có một số cân nhắc về đạo đức cần ghi nhớ. Plugin không được làm bất cứ điều gì bất hợp pháp hoặc xúc phạm đạo đức và bạn không thể bao gồm các liên kết đến các trang web bên ngoài mà không có sự cho phép của người dùng trước

Sau khi bạn gửi plugin, nó sẽ được xem xét thủ công để tìm các lỗi phổ biến và để đảm bảo rằng bạn đã tuân theo nguyên tắc thư mục plugin. Quá trình đó có thể mất từ ​​1 đến 10 ngày

Như đã nói, chúng ta hãy xem cách thêm plugin của bạn vào Thư mục plugin WordPress từng bước

Tạo một readme. txt cho Plugin của bạn

Điều đầu tiên bạn cần làm là tạo tệp 'Đọc tôi' cho plugin của bạn. Điều này sẽ được hiển thị trên trang plugin của bạn trong thư mục và cần sử dụng đúng định dạng

Đây là một tệp mẫu bạn có thể sử dụng làm điểm bắt đầu. Bạn sẽ cần dán nó vào trình soạn thảo văn bản của mình và lưu tệp dưới dạng readme. txt trong thư mục plugin của bạn

=== Your Plugin Name ===

Contributors: Your WordPress.org Username
Tags: wpbeginner, plugin tutorial
Requires at least: 5.5
Tested up to: 5.8
Stable tag: 1.0
License: GPLv2 or later
License URI: http://www.gnu.org/licenses/gpl-2.0.html
 
A WordPress plugin to teach beginners how to write a WordPress plugin. 
 
== Description ==
 
This simple plugin is part of our beginner's guide to writing a WordPress plugin. 
 
== Installation ==
 
1. Upload the plugin folder to your /wp-content/plugins/ folder.
1. Go to the **Plugins** page and activate the plugin.
 
== Frequently Asked Questions ==
 
= How do I use this plugin? =
 
Answer to the question
 
= How to uninstall the plugin? =
 
Simply deactivate and delete the plugin. 
 
== Screenshots ==
1. Description of the first screenshot. 
1. Description of the second screenshot. 
 
== Changelog ==
= 1.0 =
* Plugin released. 

Bạn sẽ cần tùy chỉnh tệp cho plugin của riêng mình, vì vậy chúng tôi sẽ giải thích cách hoạt động của cú pháp tệp readme của plugin WordPress

Dòng đầu tiên là 'Tên plugin' và sẽ xuất hiện trong Thư mục plugin WordPress dưới dạng tiêu đề plugin của bạn

Dòng tiếp theo là 'Người đóng góp'. Đây là những WordPress. ID người dùng org chịu trách nhiệm quản lý plugin của bạn. Nếu bạn chưa có ID người dùng, thì bạn sẽ cần tạo một WordPress miễn phí. tài khoản người dùng tổ chức

Các trường 'Yêu cầu ít nhất' và 'Đã kiểm tra tối đa' đề cập đến các phiên bản WordPress mà plugin của bạn hoạt động với. 'Thẻ ổn định' là phiên bản plugin của riêng bạn

Bạn có thể để nguyên các trường Giấy phép. Sau đó, bạn nên chỉnh sửa khu vực 'Mô tả' để giải thích plugin của bạn làm gì

Sau khi chỉnh sửa tệp readme của plugin, đừng quên lưu các thay đổi của bạn. Bạn cũng nên chạy tệp thông qua Trình xác thực Readme chính thức và giải quyết mọi sự cố được xác định

Cuối cùng, bạn nên nhấp chuột phải vào thư mục plugin của mình và tạo một tệp zip. Người dùng Mac nên chọn ‘Compress pluginname’ và người dùng Windows có thể chọn ‘Send to » Compressed (zipped) folder’

Đệ trình plugin của bạn vào thư mục để xem xét

Bây giờ plugin của bạn đã sẵn sàng để được WordPress xem xét. nhóm plugin của org

Để gửi nó, hãy truy cập trang Thêm plugin của bạn. Nếu bạn chưa đăng nhập, hãy nhấp vào nút đăng nhập ở góc trên cùng bên phải của màn hình

Sau khi đăng nhập, bạn sẽ có thể tải lên và gửi plugin của mình để xem xét

Chỉ cần nhấp vào nút Chọn tệp để chọn tệp zip của plugin của bạn, sau đó nhấp vào nút Tải lên

WordPress. Sau đó, nhóm đánh giá plugin của org sẽ xem xét mã plugin của bạn để biết các lỗi phổ biến và kiểm tra bảo mật. Sau khi được phê duyệt, bạn sẽ nhận được email từ nhóm plugin

Email này sẽ chứa một liên kết đến kho lưu trữ Subversion (SVN) nơi plugin của bạn sẽ được lưu trữ trên WordPress. tổ chức. Bạn sẽ cần sử dụng liên kết này khi tải lên plugin của mình

Tải lên Plugin của bạn bằng Subversion (SVN)

Sau khi plugin của bạn được phê duyệt, bạn sẽ cần sử dụng Subversion (SVN) để tải plugin lên

Subversion là một hệ thống kiểm soát phiên bản mã nguồn mở. Nó cho phép người dùng thực hiện các thay đổi đối với tệp và thư mục trong khi lưu giữ bản ghi các thay đổi, quản lý các phiên bản khác nhau và cộng tác với những người dùng khác

Bạn sẽ cần một ứng dụng khách SVN được cài đặt trên máy tính của mình để tải plugin lên. Người dùng Windows có thể sử dụng SilkSVN hoặc TortoiseSVN (miễn phí). Người dùng Mac có thể cài đặt SmartSVN hoặc ứng dụng Phiên bản trên máy tính của họ

Trong bài viết này, chúng tôi sẽ sử dụng ứng dụng Phiên bản cho Mac. Tuy nhiên, quy trình này rất giống nhau trong tất cả các ứng dụng SVN được liệt kê ở trên

Sau khi cài đặt, bạn cần mở ứng dụng Phiên bản và xem bản sao của kho lưu trữ plugin WordPress của bạn. Để làm điều đó, chỉ cần nhấp vào nút 'Dấu trang Kho lưu trữ Mới'

Thao tác này sẽ hiển thị cửa sổ bật lên trong đó trước tiên bạn cần cung cấp tên cho dấu trang này. Bạn có thể đặt tên nó theo plugin của bạn. Sau đó, bạn cần thêm URL kho lưu trữ SVN của plugin WordPress của mình

Bạn có thể để trống trường tên người dùng và mật khẩu

Bây giờ bạn nên nhấp vào nút Tạo. Các phiên bản sẽ kết nối với kho lưu trữ của bạn và tải xuống bản sao kho lưu trữ plugin của bạn về máy tính của bạn

Tiếp theo, bạn cần nhấp chuột phải vào tên kho lưu trữ trong chế độ xem trình duyệt và sau đó chọn 'Thanh toán'

Bạn sẽ được yêu cầu cung cấp tên cho thư mục và chọn vị trí bạn muốn lưu trữ trên máy tính của mình. Bạn có thể sử dụng cùng tên thư mục làm thư mục plugin của mình và nhấp vào nút thanh toán để tiếp tục

Giờ đây, ứng dụng Phiên bản sẽ tạo các thư mục cần thiết cho plugin trên máy tính của bạn. Bạn có thể xem nó trong kho lưu trữ của plugin hoặc duyệt nó trong Finder

Bây giờ bạn cần sao chép các tệp plugin của mình và dán chúng vào thư mục thân cây của kho lưu trữ cục bộ của bạn

Khi bạn làm điều đó, bạn sẽ thấy một biểu tượng dấu chấm hỏi bên cạnh các tệp mới trong ứng dụng Phiên bản

Vì những tệp này không tồn tại trước đó nên bạn cần thêm chúng. Chọn các tệp mới và nhấp vào nút Thêm để thêm các tệp này vào thư mục cục bộ của bạn

Bây giờ các tệp plugin của bạn đã được thêm vào Subversion, bạn đã sẵn sàng để tải chúng lên. Bạn làm điều này bằng cách đồng bộ hóa các thay đổi trong thư mục cục bộ của bạn và thư mục subversion

Bạn nên nhấp vào kho lưu trữ cục bộ của mình để chọn nó và sau đó nhấp vào biểu tượng Cam kết

Một cửa sổ bật lên mới sẽ xuất hiện và bạn sẽ thấy danh sách các thay đổi và một hộp để thêm thông báo cam kết. Sau khi bạn nhấp vào nút Cam kết, ứng dụng Phiên bản sẽ đồng bộ hóa các thay đổi của bạn và cam kết chúng vào kho lưu trữ plugin của bạn

Bây giờ bạn đã tải các tệp plugin của mình lên thân cây, đã đến lúc gắn thẻ chúng vào một phiên bản

Chuyển đến bản sao cục bộ của plugin của bạn và sao chép các tệp bên trong thư mục trung kế. Sau đó, bạn cần mở thư mục tags và tạo một thư mục mới bên trong nó

Đặt tên cho thư mục này bằng tên phiên bản. Đảm bảo rằng nó phù hợp với phiên bản bạn đã nhập trong tiêu đề plugin của mình. Trong mã mẫu ở trên, chúng tôi đã sử dụng phiên bản 1. 0 cho plugin của chúng tôi

Sau khi thêm 1. 0 bạn cần dán các tệp plugin của mình vào bên trong. Vì đây là một thư mục mới, bạn cũng cần nhấp vào nút Thêm để đưa thư mục và tất cả các tệp của nó vào kho lưu trữ

Sau đó, bạn có thể tiếp tục và nhấp vào biểu tượng Cam kết để đồng bộ hóa các thay đổi của mình như bạn đã làm trước đó. Bây giờ bạn có thể truy cập Thư mục plugin WordPress và xem trước plugin của mình

Bất cứ khi nào bạn cần chỉnh sửa các tệp plugin của mình, bạn nên chỉnh sửa bản sao cục bộ. Khi bạn đã hoàn tất các thay đổi của mình, chỉ cần nhấp vào biểu tượng Cam kết để đồng bộ hóa chúng với Thư mục plugin WordPress

Khi bạn đã thực hiện các thay đổi lớn đối với plugin của mình, bạn sẽ muốn thêm một phiên bản mới bằng cách thêm một thư mục mới có số phiên bản đó vào thư mục thẻ. Đảm bảo rằng số phiên bản khớp với tiêu đề plugin của bạn

Thêm tác phẩm nghệ thuật vào thư mục plugin WordPress

Bây giờ chúng ta có thể thêm một số tác phẩm nghệ thuật và ảnh chụp màn hình vào Thư mục plugin WordPress. Các mục này cần tuân theo các thông lệ đặt tên tiêu chuẩn và phải được tải lên bằng Subversion

Biểu ngữ tiêu đề plugin

Biểu ngữ tiêu đề là hình ảnh lớn xuất hiện trên đầu trang plugin. Kích thước của nó phải là 772×250 hoặc 1544×500 pixel và bạn nên sử dụng định dạng tệp JPEG hoặc PNG

Tùy thuộc vào kích thước hình ảnh và loại tệp của bạn, bạn sẽ cần đặt cho biểu ngữ tiêu đề của mình một trong những tên này

• biểu ngữ-772×250. jpg
• biểu ngữ-772×250. png
• biểu ngữ-1544×500. jpg
• biểu ngữ-1544×500. png

Biểu tượng plugin

Biểu tượng là một hình vuông nhỏ hơn và sẽ được hiển thị trong kết quả tìm kiếm và danh sách plugin. Kích thước của nó phải là 125×125 hoặc 250×250 pixel và bạn nên sử dụng định dạng tệp JPEG hoặc PNG

Tùy thuộc vào kích thước hình ảnh và loại tệp của bạn, bạn sẽ cần đặt cho biểu tượng của mình một trong những tên này

• icon-128×128. jpg
• icon-128×128. png
• icon-256×256. jpg
• icon-256×256. png

Ảnh chụp màn hình

Bạn có thể thêm bao nhiêu ảnh chụp màn hình tùy thích. Những ảnh chụp màn hình này phải được liệt kê trong phần mô tả ảnh chụp màn hình trong readme của bạn. tập tin txt

Các tệp ảnh chụp màn hình nên được đặt tên như thế này

• ảnh chụp màn hình-1. png
• ảnh chụp màn hình-2. png

Khi bạn đã chuẩn bị tất cả các tác phẩm nghệ thuật, bạn có thể đặt chúng vào thư mục nội dung của bản sao cục bộ của plugin của bạn

Sau đó, bạn sẽ thấy biểu tượng dấu chấm hỏi bên cạnh thư mục nội dung. Bạn sẽ cần nhấp vào nút Thêm để thêm tệp nội dung mới vào kho lưu trữ của mình

Cuối cùng, hãy tiếp tục và nhấp vào biểu tượng Cam kết để tải tệp của bạn lên Thư mục plugin WordPress. Sau một thời gian, bạn sẽ có thể thấy tác phẩm nghệ thuật xuất hiện trên trang plugin của mình

Chúng tôi hy vọng hướng dẫn này đã giúp bạn tìm hiểu cách thêm plugin của mình vào Thư mục plugin WordPress

Bạn cũng có thể muốn tìm hiểu cách phù hợp để tạo bản tin email hoặc xem lựa chọn của chúng tôi về các plugin phải có mà người dùng WordPress thấy hữu ích

Nếu bạn thích bài viết này, vui lòng đăng ký Kênh YouTube của chúng tôi để xem các video hướng dẫn về WordPress. Bạn cũng có thể tìm thấy chúng tôi trên Twitter và Facebook

Thư mục của plugin là gì?

Các tệp plugin được lưu trữ ở đâu?

__ dir __ trong WordPress là gì?

URL plugin trong WordPress là gì?