Manual:LocalSettings.php/vi

File  cung cấp cáccài đặt cấu hình cơ bản(dựa trên file  ) của một cài đặt MediaWiki. Bạn phải chú ý xem lại các cài đặt trong file này. File này thường được tạo ra bởi trình cài đặt web-based MediaWiki nhưng bạn cũng có thể điều chỉnh các thông số, có lẽ liên quan đến các cài đặt Apache. Đối với các cài đặt MediaWiki được cấu hình như là một wiki farm, một file được đặt tên  có thể được sử dụng.

Vị trí trên server
File LocalSettings.php không phải là 1 trang wiki và bạn không thể truy cập tới nó trên trình duyệt của bạn. Thật ra, nó là 1 file trong hệ thống file của server. Nội dung của nó được tạo ra trong quá trình cài đặt wiki ban đầu và file kết quả phải được copy vào server thủ công. File đó phải nằm trong folder mà bạn cài đặt MediaWiki vào, cùng cấp với các folder như "includes/" hoặc "skins/" và các file như "api.php". Nếu file này không nằm ở đó, wiki sẽ không làm việc - nếu wiki làm việc, file này sẽ có ở đó. Nếu bạn không biết nó nằm ở đâu, bạn có thể chạy dòng lệnh này  trên UNIX shell để server của bạn chỉ cho bạn file này đang nằm ở vị trí nào.

Bảo mật
LocalSettings.php thường chứa các dữ liệu nhạy cảm như database logins. Dữ liệu này không bao giờ được để lộ ra công cộng! Do một lỗ thủng bảo mật nào đó trên server, có thể người dùng nào đó có thể thấy được nội dung bên trong các file. Để tăng cường bảo mật cho dữ liệu của bạn, bạn phải đặt UNIX permissions cho file này để: webserver user phải được quyền truy cập vào file này. Nếu có cùng account, ai là chủ của file đó, thì bạn có thể đặt permissions giá trị 600. Đôi khi, webserver user không phải là chủ của file đó, nhưng anh ta lại là chủ của nhóm UNIX user. Trong trường hợp này, permissions có giá trị là 640. Để tăng độ bảo mật, bạn phải thu hẹp permissions xuống tới mức thấp nhất có thể.

Thêm vào đó, bạn có thể tạo ra một MySQL user, người này chỉ bị cấm bởi database sử dụng bởi wiki và cung cấp giấy ủy nhiệm cho người này trong LocalSettings.php. Bạn cũng có thể cấu hình database server của mình theo các tương tự để chỉ chấp nhận các kết nối từ localhost - điều này sẽ ngăn chạn việc truy cập từ bên ngoài trong trường hợp bị rò rỉ các ủy nhiệm.

Nội dung của file
Khi chỉnh sửa lại file LocalSettings.php, hãy đảm bảo rằng nó có quyền encoding trở lại. Bạn nên sử dụng "ANSI as UTF-8" encoding - đó là UTF-8 encoding không cần đánh dấu thứ tại byte (byte order mark -BOM).

LocalSettings.php chứa mã PHP ; chủ yếu là các định nghĩa của các biến và giá trị của chúng. Thay đổi một cài đặt thường có nghĩa là thay đổi giá trị của một biến PHP. Các thay đổi sẽ có hiệu lực ngay lập tức sau khi lưu lại tập tin trên máy chủ: Không cần phải "khởi động lại" bằng tay bất cứ thứ gì. Dù sao, trong một số trường hợp, bạn có thể cần phải xóa bộ nhớ cache trình duyệt của bạn để thực sự nhìn thấy những thay đổi mà bạn đã thực hiện.

Các giá trị mặc định của các thiết lập khác được đặt trong,  không nên chỉnh sửa làm gì; nếu các biến mà bạn muốn thay đổi chưa được đề cập đến trong   của bạn, sao chép các dòng thích hợp từ   và sửa đổi nó một cách thích hợp trong LocalSettings.php. Trong   bạn có thể thêm các dòng mới vào dưới cùng.

Within the file, there can also be several lines such as ' ', which point to extensions. These lines enable the according extension in the wiki. Those extensions may require setting the values of more variables in ; check the documentation of the according extension for further instructions.

Phiên bản của  có thể không kết thúc với một thẻ PHP đóng của  . Điều này được thực hiện nhằm mục đích, ngăn cản người nào đó vô tình thêm thông tin mới theo sau tag này. PHP sẽ hoạt động tốt mà không cần một thẻ đóng.

Nếu bạn có một wiki trên một MediaWiki wiki farm bạn có thể không có quyền ghi (có lẽ thậm chí không đọc) tập tin LocalSettings.php (xem ví dụ:  ). Wiki farm đi theo có thể có hoặc không sẵn sàng thực hiện thay đổi mà bạn mong muốn. Có lẽ nó muốn giữ cho hầu hết các thiết lập giống nhau trên tất cả các wiki của wiki farm.

Tổng quan về các thiết lập có sẵn
Xem configuration settings index và các ý kiến ​​nằm trong các tập tin cài đặt biết những gì tất cả các biến thực hiện. Một danh sách ngắn của các biến quan trọng nhất, cũng như các tính năng yêu cầu nhiều nhất, được liệt kê dưới đây.

Đường dẫn chứa wiki
Biến $IP (chứa đường dẫn) giữ đường dẫn tập tin địa phương tới các cài đặt cơ bản của wiki của bạn. Hãy chắc chắn rằng bạn chỉ đến đường dẫn tập tin này đầy đủ. Đừng bao gồm một dấu gạch chéo ở cuối đường dẫn. Từ MediaWiki 1.17, thiết $IP trong LocalSettings.php không còn cần thiết. Nó sẽ tự động mặc định tới thư mục làm việc hiện tại.

File DefaultSettings.php được nạp từ thư mục được chỉ định bởi biến IP.

Tên site
Biến $wgSitename giữ tên của cài đặt wiki của bạn. Tên này được gọi lại rất nhiều lần trên toàn hệ thống, chẳng hạn như qua MediaWiki:Pagetitle (Tiêu đề của trang). Ví dụ, khẩu hiệu Wikipedia "Từ Wikipedia, bách khoa toàn thư miễn phí" sử dụng cài đặt này.

Sự biến cách của tên trang web
Một số bản dịch giao diện sẵn sàng cho việc uốn tên trang web. Bạn có thể thiết lập 'các hình thức của từ' thích hợp trong biến $wgGrammarForms.

Ngôn ngữ của trang
Biến $wgLanguageCode kiểm soát ngôn ngữ giao diện của trang wiki của bạn. Trong khi người dùng có thể chuyển đổi ngôn ngữ mà họ nhìn thấy trong tùy chọn của họ, biến này đặt ngôn ngữ mặc định mà tất cả người dùng vô danh và người dùng đã đăng ký mới nhất phải thấy.

Đường dẫn Script
$wgScriptPath là tiền tố đường dẫn URL để truy cập các tập lệnh MediaWiki chính, đó là trung tâm hoạt động của mã nguồn của MediaWiki. Thiết lập này phải tương ứng với các cài đặt Apache, đặc biệt là nếu bạn đang sử dụng các qui tắc ghi đè của Apache.

Tên Server
$wgServer có thể được tùy ý sử dụng để ghi đè lên các phát hiện tự động. Khi wiki được truy cập từ một trong 2 localhost nơi nó chạy, từ một mạng nội bộ hoặc từ internet, các thông báo e-mail và một vài thông điệp máy tính khác sẽ thường được phân phối với các URL khác nhau. Sử dụng  ghi đè  phát hiện và tên máy chủ sẽ là hằng số.

Nếu www.example.com là địa chỉ máy chủ của wiki của bạn như nhìn thấy từ internet, thêm một dòng như sau:

Biến magic từ  có thể được sử dụng trên các trang wiki; nó bằng giá trị của  ; Tuy nhiên, trên một wiki, chẳng hạn như những trang trong gia đình WikiMedia, nơi các URL liên quan được sử dụng, nó sẽ không hoàn toàn mở rộng, ví dụ ở đây nó sẽ hiển thị, mà có thể không được nhấp được hay sao chép-dán được vào thanh địa chỉ như bình thường.

Tên script
$wgScript là tên của kịch bản PHP chính của MediaWiki (index), được đặt tên là  theo mặc định. Thay đổi tên kịch bản có thể không phải là một ý tưởng hay. Tuy nhiên, nếu bạn cảm thấy đôn đốc để làm như vậy, đây là nơi để thực hiện thay đổi của bạn. Hãy chắc chắn là bạn biết những gì bạn đang làm.

Chuyển hướng tên kịch bản
Biến $wgRedirectScript chỉ định đường dẫn URL tới kịch bản chuyển hướng để xử lý chuyển hướng trong MediaWiki. Thiết lập này là tương tự như wgScript như bạn có thể đặt cấu hình tên chính xác tên của kịch bản. Như đã đề cập ở trên, điều này có lẽ không phải một ý tưởng hay trừ khi bạn thực sự biết những gì bạn đang làm.

Đường dẫn bài viết
$wgArticlePath là đường dẫn để sử dụng khi truy cập vào một trang trong MediaWiki. Đường dẫn nên chứa đường dẫn đến kịch bản chính (thường phải sử dụng  ) và sử dụng giữ chỗ   cho tên bài viết.

Nếu bạn đang sử dụng Apache để viết lại các quy tắc để tạo nên các URL đẹp và ngắn gọn, bạn có thể cần phải điều chỉnh  để chỉ đến đường dẫn đúng. Lưu ý rằng wgArticlePath được sử dụng để xây dựng các URL từ trong MediaWiki. Nếu bạn mắc một sai lầm ở đây, các liên kết nội bộ sẽ hiển thị không chính xác trong khi bạn vẫn có thể truy cập vào trang chính bằng cách chỉ định URL chính xác theo cách thủ công. Xem hướng dẫn sử dụng:URL ngắn gọn để biết thêm thông tin về cấu hình URL.

Các giá trị điển hình làː

Vị trí Stylesheet
Sử dụng biến $wgStylePath để thiết lập đường dẫn URL tới nơi stylesheets (CSS) cho việc cài đặt MediaWiki được đặt. Biến $wgStyleDirectory nên chỉ tới cùng một vị trí, nhưng lưu ý rằng đây là một đường dẫn hệ thống tệp cục bộ để sử dụng trong nội bộ tập lệnh truy cập đến hệ thống tập tin

Vị trí upload
Thư mục tải lên là nơi các tập tin được tải lên bởi người sử dụng. Biến $wgUploadPath chỉ định đường dẫn URL, $wgUploadDirectory chỉ đến đường dẫn hệ thống tệp cục bộ.

Logo
Biến $wgLogo chỉ định biểu tượng logo đồ họa nào được hiển thị ở góc trên bên trái của tất cả các trang mediawiki. Các bước sau thay thế biểu tượng mặc định trong thư mục /wiki/skins/common/images/, thay thế /wiki với đường dẫn đến thư mục nơi bạn cài đặt phần mềm MediaWiki.

Trước tiên, sao chép bất kỳ biểu tượng nào bạn muốn vào thư mục /wiki/skins/common/images/ (thay thế /wiki với đường dẫn đến thư mục nơi bạn cài đặt phần mềm MediaWiki).

Tiếp theo, cố gắng tìm dòng trông giống như thế này trong :

Nếu không có dòng như vậy, bạn có thể sao chép và dán dòng ở trên vào cuối của tập tin.

Sau đó, sửa đổi dòng này để trỏ tới biểu tượng của bạn. Biểu tượng phải có thể truy cập được bằng web. Giá trị của biến này được thông qua trình duyệt web, trình duyệt web sẽ sử dụng nó để lấy biểu tượng. Nếu nghi ngờ, cách tốt nhất để chọn những gì để đặt ở đây là điều hướng đến biểu tượng trong trình duyệt web của bạn (ví dụ: url của logo wiki này là http://upload.wikimedia.org/wikipedia/mediawiki/b/bc/Wiki.png), và đặt url đầy đủ này làm giá trị của biến này.

Một số người chỉ cần thay thế tập tin skins/common/images/wiki.png với logo của họ. Điều này không được khuyến khích, vì biểu tượng tùy chỉnh này sẽ được ghi đè lên khi nâng cấp.

Thông tin liên lạc
Biến $wgEmergencyContact là địa chỉ e-mail của người dùng để liên hệ nếu gặp khó khăn. Địa chỉ thư điện tử này được sử dụng để gửi báo cáo lỗi nội bộ. Là một quản trị viên, bạn muốn để địa chỉ e-mail của bạn ở đây.

Biến $wgPasswordSender là địa chỉ e-mail mà e-mail được gửi đến từ, khi mật khẩu được gửi cho người sử dụng đã quên mật khẩu của họ. Chọn một địa chỉ mà người đó có thể hồi âm trong trường hợp gặp khó khăn hoặc nhầm lẫn.

Cài đặt database
MediaWiki cần quyền truy cập vào cơ sở dữ liệu (hiện tại hoặc là MySQL hoặc  PostgreSQL) để lưu trữ trang, sửa đổi, thông tin người dùng, và rất nhiều thứ nữa.

$wgDBserver có chứa tên máy chủ nơi cơ sở dữ liệu được lưu trữ. Trong hầu hết trường hợp, nó sẽ chỉ là "localhost" là cơ sở dữ liệu chạy trên cùng hệ thống, nhưng đối với các cài đặt phân tán, bạn cần phải điền vào tên miền điều kiện đầy đủ của máy tính chạy cơ sở dữ liệu đó.

$wgDBname là tên cơ sở dữ liệu của cơ sở dữ liệu được sử dụng bởi MediaWiki. Một cài đặt MySQL hoặc PostgreSQL duy nhất có thể lưu trữ nhiều hơn một cơ sở dữ liệu và bạn thậm chí có thể chạy nhiều cài đặt MediaWiki trên một máy chủ duy nhất. Đảm bảo rằng bạn đã khai báo cơ sở dữ liệu chính xác được kể ra ở đây và sử dụng các tên cơ sở dữ liệu khác nhau cho việc cài đặt các wiki khác nhau trên cùng một máy chủ cơ sở dữ liệu.

Các biến $wgDBuser và $wgDBpassword chứa tên đăng nhập và mật khẩu được sử dụng bởi MediaWiki để truy cập vào cơ sở dữ liệu. Đảm bảo rằng người dùng đã chỉ định có quyền truy cập thích hợp để có thể thao tác các bảng của wiki trên máy chủ cơ sở dữ liệu.

Quyền của người dùng
$wgGroupPermissions là một mảng kết hợp, kiểm soát quyền truy cập để tạo và chỉnh sửa các trang cho các nhóm người dùng khác của bạn. Trong mảng này, các cấp cho phép tùy chỉnh có thể được tạo ra, và các cấp cho phép cho các nhóm người dùng khác có thể được thiết lập. Xem thêm trợ giúp: các quyền của người dùng để biết thêm thông tin về các quyền hạn khác nhau và các nhóm người dùng có sẵn.

Force capital links
By default, no page name can start with a lowercase Roman letter: in an attempt to do so the first letter is converted to uppercase; if a link target, included page, image or category is specified with a name starting with a lowercase letter, the actual target etc. is the page starting with the corresponding capital.

Alternatively page names can start with a lowercase letter, in addition to the possibilities of starting with a capital, a digit, etc. For that you must adjust the $wgCapitalLinks variable. Setting it to false allows lowercase characters, true chooses the default behavior.

Cho phép các trang con
On localsettings.php, subpages are enabled on a per-namespace basis using the $wgNamespacesWithSubpages variable. For example, to enable subpages in the main namespace:

Upload hình ảnh
Before users are allowed to upload files to the MediaWiki system, you have to enable that feature. Make sure the Upload Directory is properly configured and writeable by the Apache web server process. Then set the $wgEnableUploads variable to true to allow uploading in the web user interface.

i.e. Here's some example code from includes/DefaultSettings.php to put in LocalSettings.php. If you want to be able to resize images on the fly to support thumbnails, MediaWiki needs a working ImageMagick installation. Set the $wgUseImageResize and $wgUseImageMagick variables to true once you have installed and tested ImageMagick on your system. Make sure the $wgImageMagickConvertCommand variable points to the proper location of the  command of your installation, that the command is executable by the web server process, and $wgMaxShellMemory is large enough. See for detailed information and trouble-shooting.

Ngoài ra, bạn có thể muốn thay đổi danh sách các phần mở rộng đã chấp nhận, được lưu trữ trong mảng $wgFileExtensions:

Trong trường hợp gặp rắc rối với ImageMagick, và gặp thông báo lỗi sau:

Thử thiêm dòng sau vào LocalSettings.php: $wgMimeDetectorCommand = "file -bi";

Phương trình sử dụng LaTeX
Để thể hiện công thức toán học trong LaTeX, bạn cần một cài đặt LaTex làm việc trên hệ thống của bạn. Thiết lập biến $wgUseTeX thànhtrue để kích hoạt tính năng đó. Cũng chắc chắn rằng các biến $wgMathPath, $wgMathDirectory và $wgTmpDirectory được thiết lập đúng cách, nhưng bạn có thể muốn sử dụng các giá trị mặc định trừ khi bạn có lý do tốt để thay đổi chúng.

Hỗ trợ liên wiki
Hỗ trợ Hỗ trợ liên Wiki được tích hợp sẵn vào MediaWiki, nhưng bạn cần phải đặt cấu hình tiền tố được sử dụng cho các liên kết nội bộ của bạn. Tiền tố này thường là giống như $ wgSitename, nhưng trong trường hợp bạn cần phải thay đổi như vậy, bạn đặt biến $wgLocalInterwiki thành tên ưa thích.

Ngôn ngữ của giao diện người dùng
MediaWiki cho phép cho một loạt các địa phương hóa giao diện người sử dụng ngôn ngữ thay vì sử dụng tiếng Anh làm mặc định. Nếu bạn muốn chạy wiki của bạn trong một ngôn ngữ không phải tiếng Anh, thiết lập biến $wgLanguageCode cho đúng language code (ví dụ như "vi" cho tiếng Việt, "de" cho tiếng Đức, "es" cho tiếng Tây Ban Nha, .v.v.)

Bạn có thể sử dụng bất kỳ ngôn ngữ nào được tìm thấy trong các thư mục language. Ví dụ, nếu bạn tìm thấy MessagesEs.php, bạn có thể sử dụng " " cho tiếng Tây Ban Nha. Không sử dụng " " với một chữ cái in hoa. Mặc dù nó có vẻ làm việc, không phải tất cả các dòng chữ đều được dịch.

Lưu ý: Sau khi thay đổi các mã ngôn ngữ, bạn sẽ cần phải chạy một kịch bản php để cho nó làm việc. Với công cụ dòng lệnh, bạn vào thư mục wiki của bạn, mở thư mục "maintenance", và gõ "code>php rebuildMessages.php --rebuild ". Xin lưu ý rằng trên Windows, các thư mục PHP có thể không nằm trong biến môi trường PATH.

Không phải tất cả mọi ngôn ngữ đều được hỗ trợ. Xem here để biết danh sách các thống kê địa phương hóa của. Xem translatewiki.net cho các thống kê cho mỗi phiên bản phát hành.

Cài đặt bản quyền cho trang web

 * $wgRightsPage là trang trên wiki bao gồm các bản quyền mà nó thuộc. Thông thường, sẽ là Project:Bản quyền.
 * $wgRightsUrl là trang mô tả chi tiết đầy đủ các giấy phép của bạn. (Ví dụ GNU FDL, sẽ là .)
 * $wgRightsText là văn bản ở footer của trang theo sau "Nối dung có giá trị theo" . Nó sẽ được liên kết đến trang đặc biệt trong.
 * $ RightsIcon là URL của hình ảnh được đặt ở bên trái của footer
 * Lưu ý: Nếu  là không trống, liên kết trong các thông báo bản quyền/giấy phép sẽ liên kết đến trang đó trên trang web của bạn. Nếu   trống, sau các thông báo bản quyền/giấy phép sẽ liên kết đến   để thay thế.

Để sửa đổi các điều khoản bản quyền của trang web, thêm một cái gì đó như thế này vào LocalSettings.php : Sau đó, chỉnh sửa MediaWiki:Copyright để cung cấp một thông điệp thích hợp, sử dụng  để chỉ ra vị trí nơi sẽ liên kết đến trang bản quyền của bạn.

'''Ví dụ: cài đặt một giấy phép Creative Commons

Để thiết lập một giấy phép Creative Commons làm như sau:


 * Chọn giấy phép của bạn: http://creativecommons.org/choose/
 * Kiểm tra mã HTML trả lại, ví dụ:


 * Đối với  nhập thông tin href từ anchor đầu tiên:
 * Đối với  nhập văn bản các liên kết anchor thứ hai từ (thêm "a" để biến Wiki cho một phiên bản đúng ngữ pháp hơn)
 * Đối với  nhập thông tin src từ liên kết img trong anchor đầu tiên. Bạn muốn sao chép các thẻ ra vào cho trang web của riêng bạn thay vì sử dụng từ trang web Creative Commons.


 * Để sử dụng siêu dữ liệu RDF về quyền tác giả thêm một hoặc cả hai dòng sau vào LocalSettings.php của bạn.

Tùy biến không gian tên
Bằng cách khai báo mảng $wgExtraNamespaces, và sửa đổi các mảng $wgNamespacesWithSubpages, và $wgNamespacesToBeSearchedDefault, không gian tên thêm có thể được thêm vào một cài đặt MediaWiki ; và bằng cách khai báo mảng $wgNamespaceAliases bí danh namespace có thể được thêm vào. Hãy chú ý không có bất kỳ trang nào đã đặt tên theo không gian tên đó, ví dụ như bạn đã có một trang gọi là "kỹ thuật:Hỗ trợ" và bạn tạo ra Kỹ thuật:namespace, thì sau đó trang đó sẽ không chỉ bị mất, mà bạn còn không thể remove nó từ Special:Allpages. Để khắc phục điều này, xóa không gian tên, di chuyển " Kỹ thuật:Hỗ trợ" thành "hỗ trợ" trong mainspace, xóa các trang chuyển hướng, lắp lại không gian tên, và di chuyển nó trở lại "kỹ thuật: Hỗ trợ". Xem Tùy chỉnh không gian tên để biết thêm thông tin.

Giao diện
Giao diện mặc định của trang web có thể được sửa đổi thông qua biến $wgDefaultSkin.

Xem thêm

 * Mã nguồn, tạo ra tập tin LocalSettings.php. Mã nguồn này được sử dụng để tạo ra nội dung mặc định của LocalSettings.php trong khi cài đặt.
 * Họ Wiki có thể chia sẻ cùng.
 * Extension:Cấu hình cung cấp một cách để thiết lập các cài đặt cấu hình từ một trang đặc biệt.
 * Manual:Bảo mật mật khẩu cơ sở dữ liệu - một hướng dẫn để đảm bảo mật khẩu cơ sở dữ liệu của bạn và file LocalSettings.php.