Turkish Documentation for Version 1.0.0

docs/.vuepress/config/locales/tr/sidebar.js

@@ -1,5 +1,5 @@
 module.exports = {
-  '/tr/extend/': [
+  '/extend/': [
     {
       title: 'Ana Kavramlar',
       collapsable: false,
@@ -8,46 +8,62 @@ module.exports = {
         'start',
         'frontend',
         'routes',
-        'data',
-        'distribution',
-        'update-b8',
-        'update-b10',
-        'update-b12',
-        'update-b13',
-        'update-b14',
-        'update-b15',
+        'models',
+        'api',
+        'distribution'
       ]
     },
     {
       title: 'Referans Kılavuzları',
       collapsable: false,
       children: [
         'admin',
+        'backend-events',
+        'authorization',
         'frontend-pages',
         'interactive-components',
+        'i18n',
+        'language-packs',
         'forms',
-        'backend-events',
+        'permissions',
+        'settings',
+        'testing',
+        'theme'
       ]
     },
     {
       title: 'Gelişmiş Kılavuzlar',
       collapsable: false,
       children: [
         'api-throttling',
-        'authorization',
+        'assets',
         'console',
+        'extending-extensions',
+        'extensibility',
+        'filesystem',
         'formatting',
-        'i18n',
         'mail',
         'middleware',
+        'model-visibility',
         'slugging',
         'notifications',
-        'permissions',
         'post-types',
         'search',
-        'service-provider',
-        'settings',
-        'testing',
+        'service-provider'
+      ]
+    },
+    {
+      title: 'Güncelleme Kılavuzları',
+      collapsable: false,
+      children: [
+        'update-1.0',
+        'update-b16',
+        'update-b15',
+        'update-b14',
+        'update-b13',
+        'update-b12',
+        'update-b10',
+        'update-b8',
       ]
     },
     // {
@@ -65,7 +81,7 @@ module.exports = {
     // }
   ],
 
-  '/tr/': [
+  '/': [
     {
       title: 'Giriş',
       collapsable: false,
@@ -79,26 +95,34 @@ module.exports = {
       ]
     },
     {
-      title: 'Ayarlama',
+      title: 'Kurulum',
       collapsable: false,
       children: [
+        'composer',
         'install',
         'update',
         'troubleshoot'
       ]
     },
     {
-      title: 'Yönetim',
+      title: 'Yönetims',
       collapsable: false,
       children: [
         'admin',
         'config',
-        'extensions',
+        'extensisons',
         'languages',
         'themes',
         'mail',
         'console'
       ]
+    },
+    {
+      title: 'İleri',
+      collapsable: false,
+      children: [
+        'extenders'
+      ]
     }
   ],
-}
+}

docs/tr/composer.md

@@ -0,0 +1,164 @@
+
+# Composer
+
+Flarum uses a program called composer[Composer](https://getcomposer.org) to manage its dependencies and extensions.
+You'll need to use composer if you want to:
+
+- Install or update Flarum
+- Install, update, or remove Flarum extensions 
+
+This guide is provided as a brief explanation of Composer. We highly recommend consulting the [official documentation](https://getcomposer.org/doc/00-intro.md) for more information.
+
+::: tip Composer v2
+
+Historically, Composer has caused issues on shared hosting due to huge memory use. In 2020, [Composer v2 was released](https://blog.packagist.com/composer-2-0-is-now-available/) with massive performance and memory usage improvements that eliminate these problems. Make sure your server is using Composer v2!
+
+:::
+
+## What is Composer?
+
+> Composer is a tool for dependency management in PHP. It allows you to declare the libraries your project depends on and it will manage (install/update) them for you. — [Composer Introduction]([https://getcomposer.org/doc/00-intro.md](https://getcomposer.org/doc/00-intro.md))
+
+Each Flarum installation consists primarily of Flarum core and a set of [extensions](extensions.md).Each of these has its own dependencies and releases.
+
+Back in the day, forum frameworks would manage extensions by having users upload zip files with the extension code. That seems simple enough, but issues quickly become evident:
+
+- Uploading random zip files from the internet tends to be a bad idea. Requiring that extensions be downloaded from a central source like [Packagist](https://packagist.org/) makes it somewhat more tedious to spam malicious code, and ensures that source code is available on GitHub for free/public extensions.
+- Let's say Extension A requires v4 of some library, and Extension B requires v5 of that same library. With a zip-based solution, either one of the two dependencies could override the other, causing all sorts of inconsistent problems. Or both would attempt to run at once, which would cause PHP to crash (you can't declare the same class twice).
+- Zip files can cause a lot of headache if trying to automate deployments, run automated tests, or scale to multiple server nodes.
+- There is no good way to ensure conflicting extension versions can't be installed, or that system PHP version and extension requirements are met.
+- Sure, we can upgrade extensions by replacing the zip file. But what about upgrading Flarum core? And how can we ensure that extensions can declare which versions of core they're compatible with?
+
+Composer takes care of all these issues, and more!
+
+## Flarum and Composer
+
+When you go to [install Flarum](install.md#installing), you're actually doing 2 things:
+
+1. Downloading a boilerplate "skeleton" for Flarum. This includes an `index.php` file that handles web requests, a `flarum` file that provides a CLI, and a bunch of web server config and folder setup. This is taken from the [`flarum/flarum` github repository](https://github.com/flarum/flarum), and doesn't actually contain any of the code necessary for Flarum to run.
+2. Installing `composer` packages necessary for Flarum, namely Flarum core, and several bundled extensions. These are called by the `index.php` and `flarum` files from step 1, and are the implementation of Flarum. These are specified in a `composer.json` file included in the skeleton.
+
+When you want to update Flarum or add/update/remove extensions, you'll do so by running `composer` commands. Each command is different, but all commands follow the same general process:
+
+1. Update the `composer.json` file to add/remove/update the package.
+2. Do a bunch of math to get the latest compatible versions of everything if possible, or figure out why the requested arrangement is impossible.
+3. If everything works, download new versions of everything that needs to be updated. If not, revert the `composer.json` changes
+
+When running `composer.json` commands, make sure to pay attention to the output. If there's an error, it'll probably tell you if it's because of extension incompatibilities, an unsupported PHP version, missing PHP extensions, or something else.
+
+### The `composer.json` File
+
+As mentioned above, the entire composer configuration for your Flarum site is contained inside the `composer.json` file. You can consult the [composer documentation](https://getcomposer.org/doc/04-schema.md) for a specific schema, but for now, let's go over an annotated `composer.json` from `flarum/flarum`:
+
+```jsonc
+{
+    // This following section is mostly just metadata about the package.
+    // For forum admins, this doesn't really matter.
+    "name": "flarum/flarum",
+    "description": "Delightfully simple forum software.",
+    "type": "project",
+    "keywords": [
+        "forum",
+        "discussion"
+    ],
+    "homepage": "https://flarum.org/",
+    "license": "MIT",
+    "authors": [
+        {
+            "name": "Flarum",
+            "email": "[email protected]",
+            "homepage": "https://flarum.org/team"
+        }
+    ],
+    "support": {
+        "issues": "https://github.com/flarum/core/issues",
+        "source": "https://github.com/flarum/flarum",
+        "docs": "https://flarum.org/docs/"
+    },
+    // End of metadata
+
+    // This next section is the one we care about the most.
+    // It's a list of packages we want, and the versions for each.
+    // We'll discuss this shortly.
+    "require": {
+        "flarum/core": "^0.1.0",
+        "flarum/approval": "^0.1.0",
+        "flarum/bbcode": "^0.1.0",
+        "flarum/emoji": "^0.1.0",
+        "flarum/lang-english": "^0.1.0",
+        "flarum/flags": "^0.1.0",
+        "flarum/likes": "^0.1.0",
+        "flarum/lock": "^0.1.0",
+        "flarum/markdown": "^0.1.0",
+        "flarum/mentions": "^0.1.0",
+        "flarum/nicknames": "^0.1.0",
+        "flarum/pusher": "^0.1.0",
+        "flarum/statistics": "^0.1.0",
+        "flarum/sticky": "^0.1.0",
+        "flarum/subscriptions": "^0.1.0",
+        "flarum/suspend": "^0.1.0",
+        "flarum/tags": "^0.1.0"
+    },
+
+    // Various composer config. The ones here are sensible defaults.
+    // See https://getcomposer.org/doc/06-config.md for a list of options.
+    "config": {
+        "preferred-install": "dist",
+        "sort-packages": true
+    },
+
+    // If composer can find a stable (not dev, alpha, or beta) version
+    // of a package, it should use that. Generally speaking, production
+    // sites shouldn't run beta software unless you know what you're doing.
+    "prefer-stable": true
+}
+```
+
+Let's focus on that `require` section. Each entry is the name of a composer package, and a version string.
+To read more about version strings, see the relevant [composer documentation](https://semver.org/).
+
+For Flarum projects, there's several types of entries you'll see in the `require` section of your root install's `flarum/core`:
+
+- You MUST have a `flarum/core` entry. This should have an explicit version string corresponding to the major release you want to install. For Flarum 1.x versions, this would be `^1.0.0`.
+- You should have an entry for each extension you've installed. Some bundled extensions are included by default (e.g. `flarum/tags`, `flarum/suspend`, etc), [others you'll add via composer commands](extensions.md). Unless you have a reason to do otherwise (e.g. you're testing a beta version of a package), we recommend using an asterisk as the version string for extensions (`*`). This means "install the latest version compatible with my flarum/core".
+- Some extensions / features might require PHP packages that aren't Flarum extensions. For example, you need the guzzle library to use the [Mailgun mail driver](mail.md). In these cases, the instructions for the extension/feature in question should explain which version string to use.
+
+## How to install Composer?
+
+As with any other software, Composer must first be [installed]([https://getcomposer.org/download/) on the server where Flarum is running. There are several options depending on the type of web hosting you have.
+
+### Dedicated Web Server
+
+In this case you can install composer as recommended in the Composer [guide]([https://getcomposer.org/doc/00-intro.md#system-requirements) 
+
+### Managed / Shared hosting
+
+If Composer is not preinstalled (you can check this by running `composer --version`), you can use a [manual installation](https://getcomposer.org/composer-stable.phar). Just upload the composer.phar to your folder and run `/path/to/your/php7 composer.phar COMMAND` for any command documented as `composer COMMAND`.
+
+::: danger
+
+Some articles on the internet will mention that you can use tools like a PHP shell. If you are not sure what you are doing or what they are talking about - be careful! An unprotected web shell is **extremely** dangerous.
+
+:::
+
+## How do I use Composer?
+
+You'll need to use Composer over the  **C**ommand-**l**ine **i**nterface (CLI). Be sure you can access your server over **S**ecure **Sh**ell (SSH).
+
+Once you have Composer installed, you should be able to run Composer commands in your SSH terminal via `composer COMMAND`.
+
+::: Optimizations
+
+After most commands, you'll want to run `composer dump-autoload -a`. Essentially, this caches PHP files so they run faster.
+
+:::
+
+## I don't have SSH access
+
+Most decent hosts should provide SSH access for shared hosting. If your host doesn't (and you can't switch to a good host that does offer it), hope might not yet be lost. You have several options:
+
+- Use alternatives like [Pockethold](https://github.com/UvUno/pockethold) to install Flarum. Note that you'll still need composer (and SSH) to install extensions.
+- Install composer on your computer, and run the `install` command locally. Then upload the files via FTP to your host. To make modifications (updating Flarum, installing/updating/removing extensions), download the current versions of the files, run whatever composer commands you need locally, and then replace the `composer.json` and `composer.lock` files, and the `vendor` directory of your install with your local copy. Make sure to create backups before doing this!
+- Some web hosts might provide a GUI for managing composer. The command line version is generally preferably, but if a GUI is the only possibility, consult your host's documentation for information on how to use it.
+
+Note that these workarounds are not officially supported! The only officially supported way to install and manage Flarum is through Composer.

docs/tr/console.md

@@ -48,4 +48,24 @@ Bekleyen tüm geçişleri çalıştırır. Bu, veritabanını değiştiren bir u
 
 `php flarum migrate:reset --extension [extension_id]`
 
-Bir uzantı için tüm geçişleri sıfırlayın. Bu, çoğunlukla uzantı geliştiricileri tarafından kullanılır, ancak bazen, bir uzantıyı kaldırıyorsanız ve tüm verilerini veritabanından temizlemek istiyorsanız bunu çalıştırmanız gerekebilir. Lütfen bunun çalışması için söz konusu uzantının şu anda yüklü olması ancak mutlaka etkinleştirilmesi gerekmediğini unutmayın.
+Bir uzantı için tüm geçişleri sıfırlayın. Bu, çoğunlukla uzantı geliştiricileri tarafından kullanılır, ancak bazen, bir uzantıyı kaldırıyorsanız ve tüm verilerini veritabanından temizlemek istiyorsanız bunu çalıştırmanız gerekebilir. Lütfen bunun çalışması için söz konusu uzantının şu anda yüklü olması ancak mutlaka etkinleştirilmesi gerekmediğini unutmayın.
+
+### schedule:run
+
+`php flarum schedule:run`
+
+Many extensions use scheduled jobs to run tasks on a regular interval. This could include database cleanups, posting scheduled drafts, generating sitemaps, etc. If any of your extensions use scheduled jobs, you should add a [cron job](https://ostechnix.com/a-beginners-guide-to-cron-jobs/) to run this command on a regular interval:
+
+```
+* * * * * cd /path-to-your-flarum-install && php flarum schedule:run >> /dev/null 2>&1
+```
+
+This command should generally not be run manually.
+
+Note that some hosts do not allow you to edit cron configuration directly. In this case, you should consult your host for more information on how to schedule cron jobs.
+
+### schedule:list
+
+`php flarum schedule:list`
+
+This command returns a list of scheduled commands (see `schedule:run` for more information). This is useful for confirming that commands provided by your extensions are registered properly. This **can not** check that cron jobs have been scheduled successfully, or are being run.

docs/tr/extend/README.md

@@ -1,3 +1,42 @@
-### Flarum Genişletme
+# Extending Flarum
 
-Yakında Türkçe belgeler eklenecektir.
+Flarum is minimalistic, but it's also highly extensible. In fact, most of the features that ship with Flarum are actually extensions!
+
+This approach makes Flarum extremely customizable. A user can disable any features they don't use on their forum, and install other extensions to make a forum perfect for their community.
+
+In order to achieve this extensibility, Flarum has been built with rich APIs and extension points. With some programming knowledge, you can leverage these APIs to add just about any feature you want. This section of the documentation aims to teach you how Flarum works, and how to use the APIs so that you can build your own extensions.
+
+::: warning
+
+**Both the Extension API and this documentation is a work in progress.** Be aware that future beta releases may break your extensions! If you have feedback, [we'd love to hear it](https://discuss.flarum.org/).
+
+:::
+
+## Core vs. Extensions
+
+Where do we draw the line between Flarum's core and its extensions? Why are some features included in the core, and others aren't? It is important to understand this distinction so that we can maintain consistency and quality within Flarum's ecosystem.
+
+**Flarum's core** is not intended to be packed full of features. Rather, it is a scaffold, or a framework, which provides a reliable foundation on which extensions can build. It contains only basic, unopinionated functionality that is essential to a forum: discussions, posts, users, groups, and notifications.
+
+**Bundled extensions** are features that are packaged with Flarum and enabled by default. They are extensions just like any other, and may be disabled and uninstalled. While their scope is not intended to address all use-cases, the idea is to make them generic and configurable enough that they can satisfy the majority.
+
+**Third-party extensions** are features which are made by others and are not officially supported by the Flarum team. They can be built and used to address more specific use-cases.
+
+If you are aiming to address a bug or shortcoming of the core, or of an existing bundled extension, it may be appropriate to *contribute to the respective project* rather than disperse effort on a new third-party extension. It is a good idea to start a discussion on the [Flarum Community](https://discuss.flarum.org/) to get the perspective of the Flarum developers.
+
+## Useful Resources
+
+- [This Documentation](start.md)
+- [Tips for Beginning Developers](https://discuss.flarum.org/d/5512-extension-development-tips)
+- [Developers explaining their workflow for extension development](https://discuss.flarum.org/d/6320-extension-developers-show-us-your-workflow)
+- [Extension namespace tips](https://discuss.flarum.org/d/9625-flarum-extension-namespacing-tips)
+- [Mithril js documentation](https://mithril.js.org/)
+- [Laravel API Docs](https://laravel.com/api/8.x/)
+- [Flarum API Docs](https://api.flarum.org)
+- [ES6 cheatsheet](https://github.com/DrkSephy/es6-cheatsheet)
+- [Flarum Blank Extension Generator](https://discuss.flarum.org/d/11333-flarum-extension-generator-by-reflar/)
+
+### Getting help
+
+- [Official Flarum Dev Community](https://discuss.flarum.org/t/dev)
+- [Join us on #extend in our discord chat](https://flarum.org/discord/)