1"use strict";(globalThis.webpackChunkflarum_docs=globalThis.webpackChunkflarum_docs||[]).push([[1122],{9258(e,a,n){n.r(a),n.d(a,{assets:()=>r,contentTitle:()=>l,default:()=>g,frontMatter:()=>o,metadata:()=>t,toc:()=>u});const t=JSON.parse('{"id":"languages","title":"Languages","description":"It\u2019s easy to add a new language to your basic Flarum installation. Just follow the instructions below to download and install the language pack of your choice.","source":"@site/versioned_docs/version-1.x/languages.md","sourceDirName":".","slug":"/languages","permalink":"/1.x/languages","draft":false,"unlisted":false,"editUrl":"https://github.com/flarum/docs/tree/main/versioned_docs/version-1.x/languages.md","tags":[],"version":"1.x","frontMatter":{},"sidebar":"guideSidebar","previous":{"title":"Extensions","permalink":"/1.x/extensions"},"next":{"title":"Theming","permalink":"/1.x/themes"}}');var s=n(4848),i=n(8453);const o={},l="Languages",r={},u=[{value:"Language Pack Installation",id:"language-pack-installation",level:2},{value:"Setting the Default Language",id:"setting-the-default-language",level:2},{value:"Disabling a Language Pack",id:"disabling-a-language-pack",level:2},{value:"Community Extensions",id:"community-extensions",level:2}];function d(e){const a={a:"a",em:"em",h1:"h1",h2:"h2",header:"header",p:"p",strong:"strong",...(0,i.R)(),...e.components};return(0,s.jsxs)(s.Fragment,{children:[(0,s.jsx)(a.header,{children:(0,s.jsx)(a.h1,{id:"languages",children:"Languages"})}),"\n",(0,s.jsx)(a.p,{children:"It\u2019s easy to add a new language to your basic Flarum installation. Just follow the instructions below to download and install the language pack of your choice."}),"\n",(0,s.jsxs)(a.p,{children:["Once you have added a language pack, you can ",(0,s.jsx)(a.a,{href:"#setting-the-default-language",children:"set it as the default language"})," for your forum. And if you ever find you don\u2019t need one of your installed language packs, you can always ",(0,s.jsx)(a.a,{href:"#disabling-a-language-pack",children:"disable it"}),".\nIf you\u2019re using any third-party extensions, be sure to ",(0,s.jsx)(a.a,{href:"#third-party-extensions",children:"read this"})," before you start."]}),"\n",(0,s.jsx)(a.h2,{id:"language-pack-installation",children:"Language Pack Installation"}),"\n",(0,s.jsxs)(a.p,{children:["To begin, visit the ",(0,s.jsx)(a.a,{href:"https://discuss.flarum.org/t/languages",children:"Extensions > Languages"})," tag at the Flarum Community site and find a language pack that you want to install."]}),"\n",(0,s.jsxs)(a.p,{children:["Language packs are installed the same way as ",(0,s.jsx)(a.a,{href:"/1.x/extensions",children:"extensions"}),". The language will appear in the ",(0,s.jsx)(a.strong,{children:"Extensions"})," page of the admin interface and you can enable it there."]}),"\n",(0,s.jsx)(a.p,{children:"That\u2019s all there is to it! You should now be able to use the language selector in your site\u2019s header to switch your forum\u2019s display to the new language."}),"\n",(0,s.jsx)(a.h2,{id:"setting-the-default-language",children:"Setting the Default Language"}),"\n",(0,s.jsxs)(a.p,{children:["Once you have installed a language pack and made sure it\u2019s working, you may want to set it as the default language for new users and guests. You can do that on the ",(0,s.jsx)(a.strong,{children:"Basics"})," page of the admin interface."]}),"\n",(0,s.jsx)(a.h2,{id:"disabling-a-language-pack",children:"Disabling a Language Pack"}),"\n",(0,s.jsxs)(a.p,{children:["If you decide you don\u2019t need to support a certain language, after all, you can turn it off. Simply locate the language pack in the ",(0,s.jsx)(a.strong,{children:"Extensions"})," page of the admin interface and disable it."]}),"\n",(0,s.jsx)(a.p,{children:"Disabling a language can be useful if you\u2019re running a monolingual site and don\u2019t want the language selector to appear in the site header. The language selector is hidden when only one language is enabled."}),"\n",(0,s.jsx)(a.h2,{id:"community-extensions",children:"Community Extensions"}),"\n",(0,s.jsxs)(a.p,{children:["While language packs downloaded from the Flarum Community site will generally include translations for all the extensions that come bundled with Flarum, they ",(0,s.jsx)(a.em,{children:"will not"})," as a rule cover any community extensions you may have installed. It is up to developers to provide and maintain translations for their extensions."]}),"\n",(0,s.jsx)(a.p,{children:"So before you install a community extension, you should check to make sure it includes translations for each language pack you have installed. If you find that an extension doesn\u2019t support a language you need, please contact the developer directly and arrange to have the necessary translations added."})]})}function g(e={}){const{wrapper:a}={...(0,i.R)(),...e.components};return a?(0,s.jsx)(a,{...e,children:(0,s.jsx)(d,{...e})}):d(e)}},8453(e,a,n){n.d(a,{R:()=>o,x:()=>l});var t=n(6540);const s={},i=t.createContext(s);function o(e){const a=t.useContext(i);return t.useMemo(function(){return"function"==typeof e?e(a):{...a,...e}},[a,e])}function l(e){let a;return a=e.disableParentContext?"function"==typeof e.components?e.components(s):e.components||s:o(e.components),t.createElement(i.Provider,{value:a},e.children)}}}]);
Line numbers count LF bytes from the start of the resource, as the search results do. Vendor segments are library code the classifier recognised; they are stored but not indexed. Bytes are shown as Latin1 characters, one per byte.