Skip to content

Commit

Permalink
New Crowdin updates (#454)
Browse files Browse the repository at this point in the history
* New translations service-provider.md (Spanish)

* New translations service-provider.md (German)

* New translations service-provider.md (Italian)

* New translations service-provider.md (Turkish)

* New translations service-provider.md (Chinese Simplified)

* New translations service-provider.md (Vietnamese)

* Update source file service-provider.md

* New translations frontend.md (Italian)

* New translations notifications.md (Italian)

* New translations contributing.md (Chinese Simplified)

* New translations contributing.md (Chinese Simplified)

* New translations contributing.md (Chinese Simplified)

* New translations bugs.md (Chinese Simplified)

* New translations troubleshoot.md (Chinese Simplified)

* New translations update.md (Chinese Simplified)

* New translations code.json (Chinese Simplified)

* New translations bundled-extensions-policy.md (Chinese Simplified)

* New translations admin.md (Turkish)

* New translations themes.md (Turkish)

* New translations language-packs.md (Turkish)

* New translations current.json (Turkish)

* New translations footer.json (Turkish)

* New translations navbar.json (Turkish)

* New translations language-packs.md (Turkish)

* New translations README.md (Turkish)

* New translations authorization.md (Turkish)

* New translations i18n.md (Turkish)

* New translations permissions.md (Turkish)

* New translations routes.md (Turkish)

* New translations api.md (Turkish)

* New translations models.md (Turkish)

* New translations rest-api.md (Turkish)

* New translations github-actions.md (Turkish)

* New translations scheduler.md (Spanish)

* New translations scheduler.md (German)

* New translations scheduler.md (Italian)

* New translations scheduler.md (Turkish)

* New translations scheduler.md (Chinese Simplified)

* New translations scheduler.md (Vietnamese)

* Update source file scheduler.md

* New translations install.md (Turkish)

* New translations README.md (Turkish)

* New translations backend-events.md (Turkish)

* New translations extensibility.md (Turkish)

* New translations forms.md (Spanish)

* New translations README.md (Italian)

* New translations admin.md (Italian)

* New translations forms.md (Italian)

* New translations routes.md (Italian)

* New translations README.md (Turkish)

* New translations README.md (Chinese Simplified)

* New translations code-of-conduct.md (Chinese Simplified)

* New translations scheduler.md (Chinese Simplified)

* New translations scheduler.md (Chinese Simplified)

* New translations console.md (Chinese Simplified)

* New translations extensions.md (Chinese Simplified)

* New translations authorization.md (Chinese Simplified)

* New translations extensions.md (Spanish)

* New translations install.md (Spanish)

* New translations update.md (Spanish)

* New translations composer.md (Spanish)

* New translations extension-manager.md (Spanish)

* New translations extensions.md (German)

* New translations install.md (German)

* New translations update.md (German)

* New translations composer.md (German)

* New translations extension-manager.md (German)

* New translations extensions.md (Italian)

* New translations install.md (Italian)

* New translations update.md (Italian)

* New translations composer.md (Italian)

* New translations extension-manager.md (Italian)

* New translations extensions.md (Turkish)

* New translations install.md (Turkish)

* New translations update.md (Turkish)

* New translations composer.md (Turkish)

* New translations extension-manager.md (Turkish)

* New translations extensions.md (Chinese Simplified)

* New translations install.md (Chinese Simplified)

* New translations update.md (Chinese Simplified)

* New translations composer.md (Chinese Simplified)

* New translations extension-manager.md (Chinese Simplified)

* New translations extensions.md (Vietnamese)

* New translations install.md (Vietnamese)

* New translations update.md (Vietnamese)

* New translations composer.md (Vietnamese)

* New translations extension-manager.md (Vietnamese)

* Update source file composer.md

* Update source file extensions.md

* Update source file install.md

* Update source file extension-manager.md

* Update source file update.md

* New translations admin.md (Chinese Simplified)

* New translations code-of-conduct.md (Chinese Simplified)

* New translations admin.md (Turkish)

* New translations admin.md (Turkish)

* New translations readme.md (Turkish)

* New translations admin.md (Turkish)

* New translations code-of-conduct.md (Turkish)

* New translations config.md (Turkish)

* New translations console.md (Turkish)

* New translations contributing.md (Turkish)

* New translations extensions.md (Turkish)

* New translations install.md (Turkish)

* New translations extension-manager.md (Turkish)

* New translations extensions.md (Spanish)

* New translations extensions.md (German)

* New translations extensions.md (Italian)

* New translations extensions.md (Turkish)

* New translations extensions.md (Chinese Simplified)

* New translations extensions.md (Vietnamese)

* Update source file extensions.md

* New translations admin.md (Chinese Simplified)

* New translations install.md (Chinese Simplified)

* New translations install.md (Chinese Simplified)

* New translations mail.md (Chinese Simplified)

* New translations composer.md (Chinese Simplified)

* New translations install.md (Chinese Simplified)

* New translations interactive-components.md (Chinese Simplified)

* New translations interactive-components.md (Spanish)

* New translations interactive-components.md (German)

* New translations interactive-components.md (Italian)

* New translations interactive-components.md (Turkish)

* New translations interactive-components.md (Vietnamese)

* Update source file interactive-components.md

* New translations admin.md (Chinese Simplified)

* New translations admin.md (Chinese Simplified)

* New translations code-of-conduct.md (Chinese Simplified)

* New translations console.md (Chinese Simplified)

* New translations admin.md (Chinese Simplified)

* New translations admin.md (Chinese Simplified)

* New translations api-throttling.md (Chinese Simplified)

* New translations console.md (Chinese Simplified)

* New translations api.md (Chinese Simplified)

---------

Co-authored-by: Sami Mazouz <[email protected]>
  • Loading branch information
askvortsov1 and SychO9 authored Nov 3, 2024
1 parent 4934035 commit 194ec3e
Show file tree
Hide file tree
Showing 93 changed files with 1,953 additions and 379 deletions.
18 changes: 4 additions & 14 deletions i18n/de/docusaurus-plugin-content-docs/current/composer.md
Original file line number Diff line number Diff line change
Expand Up @@ -3,14 +3,14 @@

Flarum uses a program called [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
- Install or update Flarum through the command line
- Install, update, or remove Flarum extensions through the command line

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
:::tip Geteiltes Hosting

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!
On shared hosting it is recommended to use the Extension Manager extension instead of Composer. It is a graphical interface for Composer that allows you to install, update and remove extensions without the need for SSH access. You can directly install Flarum using an archive file, without the need for Composer. With the extension manager pre-installed, check the [installation guide](install.md#installing-by-unpacking-an-archive) for more information.

:::

Expand Down Expand Up @@ -150,13 +150,3 @@ Once you have Composer installed, you should be able to run Composer commands in
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.
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@

Often, you'll want to trigger interactive components in addition to whatever content/animations you have on a given page. Depending on the nature of your extension, you may want to define custom interactive elements or reuse or extend existing ones.

Remember that all [components](frontend.md#components) used in Flarum core are exported and made available for extensions to reuse. A full list is available in our [API documentation](https://api.docs.flarum.org/js/master/identifiers.html).
All [components](frontend.md#components) and [utilities](frontend.md#flarum-utils) from Flarum core and bundled extensions are exported, making them available for reuse in other extensions. A full list is available in our [API documentation](https://api.docs.flarum.org/js/master/identifiers.html).

## Alerts

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -35,7 +35,7 @@ class CustomServiceProvider extends AbstractServiceProvider
// custom logic here, for example:
$this->container->resolving(SomeClass::class, function ($container) {
return new SomeClass($container->make('some.binding'));
})
});
}

public function boot(Container $container)
Expand Down
86 changes: 83 additions & 3 deletions i18n/de/docusaurus-plugin-content-docs/current/extensions.md
Original file line number Diff line number Diff line change
Expand Up @@ -6,23 +6,66 @@ Dieser Ansatz macht Flarum extrem anpassbar: Du kannst alle Funktionen deaktivie

Weitere Informationen zu Flarums Philosophie darüber, welche Funktionen wir im Kern enthalten, oder wenn Du deine eigene Erweiterung erstellen möchtest, findest Du in unserer [Erweiterungsdokumentation](extend/README.md). Dieser Artikel konzentriert sich auf die Verwaltung von Erweiterungen aus der Perspektive eines Forum-Administrators.

## Extension Manager

The extension manager is an extension that comes bundled with Flarum when installed via an archive. It provides a graphical interface for installing and updating both extensions and Flarum itself.

If you do not have the extension manager installed and you wish to install it, you can do so by running the following command in your Flarum directory:

```bash
composer require flarum/extension-manager:"*"
```

:::warning

The extension manager allows an admin user to install any composer package. Only install the extension manager if you trust all of your forum admins with such permissions.

:::

![extension manager admin page](https://github.com/flarum/docs/assets/20267363/d0e1f7a5-e194-4acd-af63-7b8ddd95c26b)


## Erweiterungen finden

Flarum verfügt über ein breites Ökosystem von Erweiterungen, von denen die meisten Open Source und kostenlos sind. Um neue und tolle Erweiterungen zu finden, besuche das [Extensions](https://discuss.flarum.org/t/extensions)-Tag in Flarums Community-Foren. Die inoffizielle [Extiverse Erweiterungsdatenbank](https://extiverse.com/) ist ebenfalls eine großartige Ressource.

## Erweiterungen installieren

### Through the interface

Using the extension manager extension, you can install extensions directly from the admin dashboard. Once you have browsed the list of available extensions from the links above, and found one you want to install, you can install it by entering the extension's composer package name into the extension manager's installation input.

![Installing an extension](/en/img/install-extension.png)

### Through the command line

Genau wie Flarum werden Erweiterungen über [Composer](https://getcomposer.org) mit SSH installiert. So installierst Du eine typische Erweiterung:

1. `cd` in dein Flarumverzeichnis. Dieses Verzeichnis sollte `composer.json`, `flarum`-Dateien und ein `storage`-Verzeichnis (unter anderem) enthalten. Du kannst Verzeichnisinhalte über `ls -la` überprüfen.
2. Führe `composer require COMPOSER_PACKAGE_NAME:*` aus. Dies sollte durch die Dokumentation der Erweiterung bereitgestellt werden.

## Aktualisieren von Erweiterungen

### Through the interface

Using the extension manager extension, you can update extensions directly from the admin dashboard. You can run a check for updates by clicking the "Check for updates" button in the extension manager. If there are updates available, you can update all extensions by clicking the "Global update" button. Or, you can update individual extensions by clicking the "Update" button next to the extension you want to update.

![Updating an extension](/en/img/update-extension.png)

### Through the command line

Anweisungen der Erweiterungsentwickler befolgen. Wenn Du `*` als Versionszeichenfolge für Erweiterungen verwendest ([wie empfohlen](composer.md)), sollten all deine Erweiterungen aktualisiert werden, indem Du die Befehle ausführst, die in der [Flarum-Upgrade-Anleitung](update.md) aufgeführt sind.

## Erweiterungen deinstallieren

### Through the interface

Using the extension manager extension, you can uninstall extensions directly from the admin dashboard. You can uninstall an extension by clicking the "Uninstall" button next to the extension you want to uninstall inside the extension's page.

![Uninstalling an extension](/en/img/uninstall-extension.png)

### Through the command line

Ähnlich wie bei der Installation, um eine Erweiterung zu entfernen:

0. Wenn Du alle von der Erweiterung erstellten Datenbanktabellen entfernen möchtest, klicke im Admin-Dashboard auf die Schaltfläche „Löschen“. Weitere Informationen findest Du [unten](#managing-extensions).
Expand All @@ -31,8 +74,45 @@ Anweisungen der Erweiterungsentwickler befolgen. Wenn Du `*` als Versionszeichen

## Verwalten von Erweiterungen

Die Erweiterungsseite des Admin-Dashboards bietet eine bequeme Möglichkeit, Erweiterungen zu verwalten, wenn sie installiert sind. Du kannst:
Each individual extension page of the admin dashboard provides a convenient way to manage the extension. Du kannst:

- Eine Erweiterung aktivieren oder deaktivieren
- Auf die Erweiterungseinstellungen zugreifen (obwohl einige Erweiterungen eine Registerkarte in der Hauptseitenleiste für Einstellungen verwenden)
- Enable or disable the extension.
- See the settings provided by the extension, and change them.
- Migrationen einer Erweiterung zurücksetzen, um alle vorgenommenen Datenbankänderungen zu entfernen (dies kann mit der Schaltfläche „Löschen“ erfolgen). Dadurch werden ALLE mit der Erweiterung verknüpften Daten entfernt und sind irreversibel. Dies sollte nur durchgeführt werden, wenn Du eine Erweiterung entfernst und nicht vorhast, sie erneut zu installieren. Es ist auch völlig optional.
- See the extension's README, if it has one.
- See the extension's version.
- Uninstall the extension if the extension manager is installed.

## Configuring additional extension repository sources

The extension manager uses `composer` under the hood, and as such, it looks for extension packages in the same places as `composer`. By default, this is [Packagist](https://packagist.org/). However, you can configure additional sources for the extension manager to look for extensions in. This is useful if you want to install an extension that is not available on Packagist.

In the admin page of the extension manager, clicking the **Add Repository** button will open a modal where you can enter the name and URL of the repository you want to add. The name is just a label for the repository, and can be anything you want. The URL should be the URL of the repository which depends on the type of repository you want to add.

### Adding a repository from a VCS

If you want to add a repository from a VCS (e.g. GitHub, GitLab, BitBucket, etc), the URL should be the URL of the repository's VCS. For example, if you had a private GitHub repository at `https://github.com/acme/flarum-extension`, you would enter that URL into the URL field. If it is a private source, you will need to enter an authentication method through the **New authentication method** button. The token can be generated from your VCS provider's website, and the host should be the domain of the VCS provider (e.g. `github.com`).

### Adding a composer repository

Extiverse provides access to premium extensions. It is a good example of a composer repository. You would specify the URL as `https://flarum.org/composer/` and the name as `premium`. You would also need to enter an authentication method through the **New authentication method** button. The token can be generated from your Flarum account's [subscriptions](https://flarum.org/dashboard/subscriptions) page with the Instructions button.

* Type: `HTTP Bearer`
* Host: `flarum.org`

![Configure repositories](/en/img/config-repositories.png)

:::info

The configured repositories and auth methods will be active for both the command line and the admin dashboard. If you configure them from the command line however, you must not include the flag `--global`.

:::

## Installing Non-stable extensions

If for whatever reason you want to install a non-stable extension (e.g. a beta, alpha or RC version) you must first update the **Minimum stability** setting to the wanted stability.

* If you set it to Alpha, you will be able to install alpha, beta, RC (Release Candidate) and stable versions.
* If you set it to Beta, you will be able to install beta, RC and stable versions.
* If you set it to RC, you will be able to install RC and stable versions.
* If you set it to Stable, you will only be able to install stable versions.
Loading

0 comments on commit 194ec3e

Please sign in to comment.