Thứ hai, 16/09/2013 | 00:00 GMT+7

Cách tùy chỉnh MediaWiki bằng tệp LocalSettings.php

MediaWiki là một ứng dụng wiki open-souce cho phép bạn tạo các trang wiki có thể tùy chỉnh của bạn . Ban đầu được phát triển bởi WikiMedia Foundation để phục vụ nhu cầu của Wikipedia, nó có thể được điều chỉnh cho các cá nhân và tổ chức nhỏ hơn.


Hướng dẫn này giả định bạn đã cài đặt MediaWiki trên VPS của bạn và đã hoàn thành các bước cấu hình ban đầu với trình duyệt web . Nếu không phải như vậy, vui lòng làm theo hướng dẫn tại đây để cài đặt MediaWiki .

Trong hướng dẫn trước, ta đã cài đặt MediaWiki trên bản cài đặt Ubuntu 12.04. Trong bài viết này, ta sẽ xem xét một số cấu hình cơ bản có thể được thực hiện thông qua file LocalSettings.php .

Bạn có thể chỉnh sửa tùy chọn thông qua giao diện web không?


Mặc dù nhiều thay đổi tùy chọn và các việc quản lý trang web có thể được quản lý thông qua giao diện web wiki thông thường, nhưng có một số thay đổi yêu cầu chỉnh sửa file văn bản trên server .

Không thể truy cập file LocalSettings.php từ giao diện web như một biện pháp bảo mật. Để chỉnh sửa file , hãy SSH vào VPS của bạn để chỉnh sửa file này theo cách thủ công.

MediaWiki lưu trữ giá trị mặc định ở đâu?


Cài đặt mặc định được giữ trong một file có tên là DefaultSettings.php .

Bạn không bao giờ nên chỉnh sửa DefaultSettings.php , nhưng nhìn vào nó có thể rất có giá trị. Vì ta sẽ không chỉnh sửa file , hãy mở file trong máy nhắn tin:

less /etc/mediawiki/includes/DefaultSettings.php 

Nếu bạn thấy một giá trị trong file này mà bạn muốn thay đổi, hãy ghi lại nó. Sau đó, bạn có thể thêm giá trị vào file LocalSettings.php .

Làm thế nào để bạn chỉnh sửa giá trị mặc định?


Cấu hình phải được thực hiện trong file LocalSettings.php . Nó trông rất giống với DefaultSettings.php , nhưng ngắn hơn. Nhập lệnh sau để mở file để chỉnh sửa:

sudo nano /etc/mediawiki/LocalSettings.php 

File này được viết bằng ngôn ngữ lập trình PHP, nhưng cú pháp tương đối dễ hiểu. Đối với hầu hết các phần, bạn sẽ thấy cú pháp sau:

<pre>
$ <span class = “highlight”> VariableName </span> = “<span class =" highlight "> VariableValue </span>“;
</pre>

Tệp này có nhiều cài đặt cấu hình khác nhau, nhưng không phải tất cả các cài đặt có sẵn đều được xác định ở đây. Nói chung, chỉ những cài đặt có giá trị mâu thuẫn với giá trị mặc định trong DefaultSettings.php được tìm thấy ở đây.

Nếu bạn muốn thay đổi cài đặt của bất kỳ thứ gì được tìm thấy trong DefaultSettings.php , hãy tìm biến trong LocalSettings.php . Nếu nó không tồn tại, hãy thêm nó vào dưới cùng.

Cài đặt cấu hình chung


Trước khi thực hiện bất kỳ thay đổi nào, hãy tiếp tục và backup file cấu hình trong trường hợp có điều gì đó không hoạt động như mong đợi:

sudo cp /etc/mediawiki/LocalSettings.php /etc/mediawiki/LocalSettings.php.bak 

Mở lại file LocalSettings.php để chỉnh sửa các giá trị sau.

sudo nano /etc/mediawiki/LocalSettings.php 

Cách thay đổi tên trang web


Bạn đã chọn một tên cho trang web của bạn trong quá trình cấu hình ban đầu. Bạn có thể thay đổi tên trang web của bạn bằng cách chỉnh sửa hai biến: wgSitenamewgMetaNamespace .

<pre>
$ wgSitename = ”<span class =“ highlight ”> Tên trang web mới </span>“;
$ wgMetaNamespace = ”<span class =“ highlight ”> Tên trang web mới </span>“;
</pre>

Biến thứ hai đặt không gian tên cho các trang tham chiếu đến chính wiki. Nó không thể chứa khoảng trắng, vì vậy ta sử dụng dấu gạch dưới để thay thế.

Cách thay đổi ngôn ngữ trang web


Nếu bạn cần thay đổi mã hóa ngôn ngữ của trang web của bạn , bạn có thể sửa đổi giá trị của biến wgLanguageCode :

<pre>
$ wgLanguageCode = ”<span class =“ highlight ”> language_code </span>“;
</pre>

"Language_code" trong trường hợp này đề cập đến bất kỳ giá trị nào được xác định trong file này:

less /etc/mediawiki/languages/Names.php 

Sau khi thay đổi ngôn ngữ, bạn cần chạy một tập lệnh để thực hiện thay đổi:

cd /etc/mediawiki/maintenance sudo php rebuildmessages.php --rebuild 

Cách Cho phép Tải lên Hình ảnh


Trước khi cho phép tải hình ảnh lên wiki, ta muốn cài đặt thêm một số phần mềm xử lý hình ảnh từ bộ “imagemagick”:

sudo apt-get install imagemagick 

Mở lại file LocalSettings.php .

sudo nano /etc/mediawiki/LocalSettings.php 

Để cho phép user wiki của bạn tải hình ảnh của chính họ lên các trang, bạn có thể thay đổi biến wgEnableUploads thành “true”:

$wgEnableUploads = true; 

Bỏ ghi chú hai biến tiếp theo để cấu hình MediaWiki sử dụng imagemagick để thay đổi kích thước hình ảnh, chuyển đổi và thao tác.

$wgUseImageMagick = true; $wgImageMagickConvertCommand = "/usr/bin/convert"; 

Các cài đặt này sẽ cho phép khả năng sử dụng hình ảnh thu nhỏ để tải lên của user .

Theo mặc định, các cài đặt này cho phép tải lên ở các định dạng “png”, “gif” và “jpeg / jpg”. Nếu bạn muốn cho phép các định dạng bổ sung, hãy thêm biến wgFileExtensions vào cuối file như sau:

<pre>
$ wgFileExtensions = array ('png', 'gif', 'jpg', 'jpeg', '<span class = "highlight"> pdf </span>', '<span class = "highlight"> add_format </ span > ',' <span class = “highlight”>… </span> ')
</pre>

Lưu ý: Bất kỳ trang web nào chấp nhận nội dung từ user đều đang chấp nhận một mức độ rủi ro nhất định! Đảm bảo rằng bạn nhận thức được tác động của việc cho phép user tải lên và thực hiện các bước thích hợp để giảm thiểu những nguy hiểm này.

Cách cho phép Hình ảnh WikiCommons


Một biến bổ sung mà bạn có thể cần đặt thành “true” là wgUseInstantCommons .

Điều này cho phép wiki của bạn tự động cấu hình quyền truy cập vào nội dung trong Wikimedia Commons . Chúng có thể được kết hợp vào các trang của bạn .

$wgUseInstantCommons = true; 

Để sử dụng hình ảnh từ Wikimedia Commons, hãy tìm hình ảnh bạn muốn sử dụng tại:

http://commons.wikimedia.org/ 

Điều hướng đến hình ảnh của bạn. Trong URL, sao chép từ File: đến cuối URL.

<img style = “border: 2px màu đen đặc; display: block; margin-left: auto; margin-right: auto ”src =“ https://assets.digitalocean.com/articles/mediawiki_config/wikimedia_url.png ”alt =“ URL file MediaWiki ”/>

Bây giờ, hãy mở hoặc chỉnh sửa một trang và chỉ cần dán những gì bạn đã sao chép vào trong dấu ngoặc kép

[[File:Parson_Russell_Terrier_Puppy_3_Months_Old.jpg]] 

Hình ảnh sẽ có sẵn trên trang web .

Thay vào đó, nếu bạn muốn tạo hình thu nhỏ, hãy theo tên file với ký tự ống dẫn (|) và “thumb”.

[[File:Parson_Russell_Terrier_Puppy_3_Months_Old.jpg|thumb]] 

Hình ảnh WikiMedia sẽ hiển thị trên wiki của bạn:

<img style = “border: 2px màu đen đặc; display: block; margin-left: auto; margin-right: auto ”src =“ https://assets.digitalocean.com/articles/mediawiki_config/commons_image.png ”alt =“ Hình ảnh mẫu của MediaWiki Commons ”/>


Một thông tin thường được yêu cầu là cách thay đổi biểu trưng ở góc trên bên trái của trang thành biểu tượng nào đó có liên quan đến trang web .

Theo mặc định, trang wiki hiển thị hình ảnh sau:

<img style = “border: 2px màu đen đặc; display: block; margin-left: auto; margin-right: auto ”src =“ https://assets.digitalocean.com/articles/mediawiki_config/default_logo.png ”alt =“ Biểu trưng mặc định của MediaWiki ”/>

Trước tiên, hãy sao chép file bạn muốn đóng role như biểu trưng của bạn vào folder thích hợp trên VPS của bạn:

<pre>
scp <span class = “highlight”> / path / to / local / image.png </span> <span class = “highlight”> tên user </span> @ <span class = “highlight”> server_ip </span> : / etc / mediawiki / skin / common / images /
</pre>

Đến đây bạn có hình ảnh trên server wiki của bạn . Thay đổi đường dẫn của wgLogo để phản ánh tên hình ảnh:

<pre>
$ wgLogo = “$ wgStylePath / common / images / <span class =" highlight "> image_name.png </span>
</pre>

Biểu trưng của bạn bây giờ sẽ thay thế thông báo cũ.

Cách cấu hình các tùy chọn email


Để nhận email quản trị, bao gồm báo cáo lỗi, hãy bao gồm email của bạn sau biến wgEmergencyContact .

<pre>
$ wgEmergencyContact = “<span class =" highlight "> your_email@address.com </span>“
</pre>

Bạn cũng cần cấu hình email wgPasswordSender để trỏ đến một địa chỉ email thực, để user có thể trả lời email nếu họ gặp sự cố.

<pre>
$ wgPasswordSender = ”<span class =“ highlight ”> password_email@address.com </span>“
</pre>

Kết luận


Đến đây bạn sẽ biết cách cấu hình một số cài đặt phổ biến nằm trong file LocalSettings.php .

Có rất nhiều cài đặt cấu hình có sẵn cho MediaWiki không có trong LocalSettings.php theo mặc định. Hãy nhớ đọc file cài đặt mặc định có tại /etc/mediawiki/includes/DefaultSettings.php để khám phá thêm các tùy chọn cấu hình. Tệp được comment tốt. Thông tin thêm về các biến cụ thể có thể được tìm thấy tại đây.

<div class = "author"> Bởi Justin Ellingwood </div>


Tags:

Các tin liên quan

Bắt đầu với Yii PHP Framework - Phần 2
2013-08-12
Cách lưu trữ các phiên PHP trong Memcached trên CentOS VPS
2013-08-05
Cách sử dụng Gmail hoặc Yahoo với chức năng PHP mail ()
2013-08-02
Cách tạo plugin Nagios với PHP trên Ubuntu 12.10
2013-04-29
Cách tạo plugin Nagios với PHP trên CentOS 6
2013-04-29