Skip to content

Commit

Permalink
Merge pull request #239 from shi82421/dev
Browse files Browse the repository at this point in the history
m revision
  • Loading branch information
qiaofeng1227 authored Sep 7, 2024
2 parents 1115859 + 78e76c8 commit 2afa29c
Show file tree
Hide file tree
Showing 16 changed files with 165 additions and 159 deletions.
70 changes: 38 additions & 32 deletions i18n/en/docusaurus-plugin-content-docs/current/apps/magento.md
Original file line number Diff line number Diff line change
Expand Up @@ -15,84 +15,90 @@ import Meta from './_include/magento.md';

### Login verification{#verification}

Completed installation Magento at Websoft9 console, get the applicaiton's overview and access credentials from **My Apps**
Completed the installation of Magento at the Websoft9 console, and get the applicaiton's overview and access credentials from **My Apps**

![](./assets/magento-backend-websoft9.png)

### Switch to Chinese {#setlanguage}

Websoft9 has pre-built Magento's Chinese package file zh_Hans_CN, just enable it:
Websoft9 has pre-built Magento's Chinese package file `zh_Hans_CN`. To enable it:

#### Backend

Login to Magento as administrator, select **Account Setting(on upper right) > Interface Local**, select Interface Local as Chinese.
1. Log in to Magento as an administrator.
2. Select **Account Settings** (at the upper right) > **Interface Locale**.
3. Set **Interface Locale** to Chinese.

#### frontend

1. Enter the command mode of the Magento container and run the following command
1. Enter the command mode of the Magento container and run the following command:
```
cd /bitnami/magento/
php bin/magento config:set --scope=stores --scope-code=default general/locale/code zh_Hans_CN
php bin/magento cache:clean
php bin/magento cache:flush
```

2. Log in to Magento as administrator, open: Stores > Configuration > General > Locale Options, set Locale to Chinese.
2. Log in to Magento as an administrator, and navigate to: Stores > Configuration > General > Locale Options, then set **Locale** to Chinese.


### Install extensions {#installplugin}

Extensions are anything that is not part of Magento's core functionality, including modules, bodies, language packs, etc.
Extensions are additional functionalities not part of Magento's core, including modules, language packs, etc.

Extensions are installed by connecting to Magento's composer repository via php composer. To install an extension, you need to enter the repository's [Access Key](#key).
They are installed by connecting to Magento's composer repository via PHP Composer. To install an extension, you need to enter the repository's [Access Key](#key).

Refer to: [Install an extension](https://experienceleague.adobe.com/en/docs/commerce-operations/installation-guide/tutorials/extensions)


### Setting up the Access Key{#key}

The Access Key is the credentials for Magento to use Marketplace resources:
The Access Key is required for Magento to use Marketplace resources:

1. Register a [Magento account](https://account.magento.com/applications/customer/login), log in to Marketplace, and create your own Access Key from the Access Keys page of your My Profile.
1. Register a [Magento account](https://account.magento.com/applications/customer/login), log in to Marketplace, and create your own Access Key from the Access Keys page of your Profile.

2. Create a new file auth.json based on auth.json.example in the root directory of your Magento application.
2. Create a new file named `auth.json` based on `auth.json.example` in the root directory of your Magento application.

3. Fill in the auth.json file with the Access Key.
3. Populate the auth.json file with the Access Key.


### Caching and Indexing

After configuring Magento, you may need to refresh the cache or rebuild the index:

- Via the Magento backend: `System` > `Tools`.
- Command line settings: `php bin/magento cache:flush`, `php magento indexer:reindex`
- Via the Magento backend: Navigate to `System` > `Tools`.
- Command line: Use the following commands:
```
php bin/magento cache:flush
php magento indexer:reindex
```

## Configuration options{#configs}

- [Extension Management](https://experienceleague.adobe.com/en/docs/commerce-operations/installation-guide/tutorials/extensions)

- CLI: `magento list`
- CLI: Use the command `magento list`

- [API](https://devdocs.magento.com/guides/v2.2/get-started/bk-get-started-api.html)

- Multilingual (✅ ): you need to download the language pack and import it.
- Multilingual (✅ ): Download and import the language pack.

- Online Backup: **Stores > Configuration > ADVANCED > Backup Settings**.
- Online Backup: Configure via **Stores > Configuration > ADVANCED > Backup Settings**.

- SMTP (✅ )
1. Refer to [Email communications](https://experienceleague.adobe.com/zh-hans/docs/commerce-admin/systems/communications/email-) for SMTP parameters. communications) Fill in the SMTP parameters
1. Refer to [Email communications](https://experienceleague.adobe.com/zh-hans/docs/commerce-admin/systems/communications/email-) for SMTP parameters.

2. Fill in the sender's email address (same name as the SMTP email address) in **Backup > Store > Configuration > Store Email Address > General Contact**.
2. Fill in the sender's email address (matching the SMTP email address) under **Backup > Store > Configuration > Store Email Address > General Contact**.

## Administer{#administrator}

- **Replacement of URL additional settings**: After changing the Magneto domain name in the Websoft9 console, you also need to update the Magento URL via the CLI
- **Replacement of URL additional settings**: After changing the Magneto domain name in the Websoft9 console, update the Magento URL via CLI
```shell
php bin/magento config:set web/unsecure/base_url http://www.mydomain.com/ # change to your actual domain name, must end with /
php bin/magento config:set web/unsecure/base_url http://www.mydomain.com/ # change to your actual domain name, must end with /
```

- **Additional HTTPS settings**: After setting up Magento's HTTPS in the Websoft9 console, you also need to configure it via CLI commands:
- **Additional HTTPS settings**: After setting up Magento's HTTPS in the Websoft9 console, configure it via CLI commands:
```
#1 set your url
php bin/magento setup:store-config:set --use-secure=1 --use-secure-admin=1 --base-url-secure="https://www.yourdomain.com/”
Expand All @@ -101,27 +107,27 @@ After configuring Magento, you may need to refresh the cache or rebuild the inde
php bin/magento cache:flush
```

- **Upgrade**: Magento upgrades are very complex, refer to the relevant documentation
- **Upgrade**: Magento upgrades can be complex. Refer to the relevant documentation
- [Recommended reading for upgrade planning](https://experienceleague.adobe.com/en/docs/commerce-operations/upgrade-guide/resources/recommended-reading)
- [Perform an upgrade](https://experienceleague.adobe.com/en/docs/commerce-operations/upgrade-guide/implementation/perform-upgrade)

## Troubleshooting{#troubleshooting}

#### Cron job warning?

Reason: One or more indexers are invalid. Make sure your Magento cron job is running
Solution: Need to rebuild the indexes and refresh the page in the backend.
Reason: One or more indexers are invalid. Ensure your Magento cron job is running
Solution: Rebuild the indexes and refresh the backend page.
```
php bin/magento indexer:reindex
```

#### Magento running slow?

Magento is a complex enterprise-level e-commerce system that requires high computing resources.
Magento is a complex enterprise-level e-commerce system that requires significant computing resources.

#### Can't find the backend login?

Enter the Magento container and view or modify it with the command ``shell:
Enter the Magento container and view or modify it using:

```shell.
# Show Magento(URL)
Expand All @@ -133,9 +139,9 @@ magento setup:config:set --backend-frontname=[yourAdminUrl] -n

#### Redirection causing inaccessibility?

Description: Error message ERR_TOO_MANY_REDIRECTS magento admin
Reason: If we exclude redirection problems in the `.htaccess` file, the most likely cause is the URL
Solution: Change the URL via command line or **core_config_data** datasheet
Description: Error message ERR_TOO_MANY_REDIRECTS in Magento admin
Reason: If redirection issues in the `.htaccess` file are excluded, the most likely cause is the URL configuration
Solution: Change the URL via the command line or **core_config_data** datasheet

```shell
php bin/magento setup:store-config:set --use-secure=1 --use-secure-admin=1 --base-url-secure="https://www.yourdomain.com/”
Expand All @@ -144,7 +150,7 @@ php bin/magento cache:flush
#### After setting HTTPS, the page is messed up?
Description: After setting HTTPS, the website can be accessed, but the page is messed up.
Description: The website is accessible, but the page layout is broken.
Solution:
Expand All @@ -166,7 +172,7 @@ php bin/magento maintenance:disable
#### Product detail page not displaying properly?
Description: The frontend can't display product information properly, error “We can't find products matching the selection”
Reason: After log investigation, it is found that the product attribute **eanl3** field is abnormal.
Solution: **STORES > Attributes > Product** reset this field.
Description: The frontend can't display product information properly, showing the error “We can't find products matching the selection”
Reason: Investigation might reveal that the product attribute **eanl3** field is abnormal.
Solution: Reset this field via **STORES > Attributes > Product**.
Original file line number Diff line number Diff line change
Expand Up @@ -15,11 +15,11 @@ import Meta from './_include/manageiq.md';

### Login Verification{#verification}

1. Completed installation ManageIQ at Websoft9 console, get the applicaiton's overview and access credentials from **My Apps**
1. After completing the installation of ManageIQ in the Websoft9 console, get the applicaiton's overview and access credentials from **My Apps**

2. Ensure Domain Binding for ManageIQ and Set Up HTTPS Access(**Necessary Condition**)

3. Starting to verify it, and update the password
3. Begin verification and update the password

## Configuration options{#configs}

Expand Down
8 changes: 4 additions & 4 deletions i18n/en/docusaurus-plugin-content-docs/current/apps/matomo.md
Original file line number Diff line number Diff line change
Expand Up @@ -15,13 +15,13 @@ import Meta from './_include/matomo.md';

### Initial setup{#wizard}

1. After installing Matomo in the **Websoft9 console**, view the application details through **My Applications** and get the login information in the **Access**.
1. After installing Matomo via the **Websoft9 console**, view the application details through **My Applications** and get the login information from **Access**.

2. Access the URL with local computer browser and enter the initialization wizard.
2. Access the URL using a local computer browser and procceed through the initialization wizard.

3. Follow the wizard to complete the next steps: set up database connection (default value is recommended), create an administrative account, and add the first monitored site.
3. Follow the wizard to complete the setup by: configuring the database connection (default values are recommended), creating an administrative account, and adding your first monitored site.

4. Login to the backend and get the JS script of the monitored website.
4. Log in to the backend and get the JS script of the monitored website.
![](./assets//matomo-backend-websoft9.png)


Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -14,13 +14,13 @@ import Meta from './_include/mattermost.md';

### Initial setup{#wizard}

1. After installing Mattermost in the **Websoft9 console**, view the application details through **My Applications** and get the login information in the **Access**.
1. After installing Mattermost via the **Websoft9 console**, view the application details through **My Applications** and get the login information from **Access**.

2. Access the URL with local computer browser and enter the initialization wizard.
2. Access the URL using a local computer browser and complete the initialization wizard.

3. Follow the wizard through the next steps: create an admin account, create a team, etc.
3. Follow the wizard's steps to create an admin account, set up a team, and configure other settings.

4. Login to the backend to get started.
4. Log in to the backend to get started.
![](./assets/mattermost-backend-websoft9.png)

## Configuration options{#configs}
Expand All @@ -36,11 +36,11 @@ import Meta from './_include/mattermost.md';
/opt/mattermost/bin/mmctl -h
```
- [Mattermost API Reference](https://api.mattermost.com/)
- Setting the maximum number of users for a team: **SITE CONFIGURATION > Users and Teams > Max Users Per Team**
- Setting the maximum number of users per team: **SITE CONFIGURATION > Users and Teams > Max Users Per Team**

## Administer{#administrator}

- Additional action for URL change: After changing the domain name through the Websoft9 console, you also need to change the **Site URL** in the Mattermost backend: **ENVIRONMENT > Web Server**.
- Additional action for URL change: After changing the domain name through the Websoft9 console, also update the **Site URL** in the Mattermost backend: **ENVIRONMENT > Web Server**.

## Troubleshooting{#troubleshooting}

Expand Down
4 changes: 2 additions & 2 deletions i18n/en/docusaurus-plugin-content-docs/current/apps/mautic.md
Original file line number Diff line number Diff line change
Expand Up @@ -16,9 +16,9 @@ import Meta from './_include/mautic.md';

### Initial setup{#wizard}

1. When completed installation of Mautic at Websoft9 console, get the applicaiton's overview and access information from **My Apps**
1. When completing the installation of Mautic in the Websoft9 console, get the applicaiton's overview and access information from **My Apps**

2. Complete database connection (keep default values) and initial account settings according to the wizard
2. Complete the database connection (using the default values) and configure the initial account settings as prompted by the wizard

## Configuration options{#configs}

Expand Down
10 changes: 5 additions & 5 deletions i18n/en/docusaurus-plugin-content-docs/current/apps/mediawiki.md
Original file line number Diff line number Diff line change
Expand Up @@ -18,21 +18,21 @@ import Meta from './_include/mediawiki.md';

### Initial setup{#wizard}

1. When completed installation of Mediawiki at **Websoft9 Console**, get the applicaiton's **Overview** and **Access** information from **My Apps**
1. When completing the installation of Mediawiki in the **Websoft9 Console**, get the applicaiton's **Overview** and **Access** information from **My Apps**

### Quick setup

- Install extensions: [Manual:Extensions](https://www.mediawiki.org/wiki/Manual:Extensions/zh)
- Visual Editor: [Help:Starting_a_new_page](https://www.mediawiki.org/wiki/Help:VisualEditor/User_guide/zh)
- File Upload: [Help:FAQ:Enabling File Upload](https://www.mediawiki.org/wiki/Manual:FAQ/zh#如何启用文件上传?)
- Language Settings: [Help:FAQ:Language Settings](https://www.mediawiki.org/wiki/Manual:FAQ/zh#我如何更改界面语言?)
- Interface Customization: [Help:FAQ:Customize Interface](https://www.mediawiki.org/wiki/Manual:FAQ/zh#定制界面), modify Logo, set navigation bar, modify CSS, etc
- Interface Customization: [Help:FAQ:Customize Interface](https://www.mediawiki.org/wiki/Manual:FAQ/zh#定制界面), including modifying the logo, setting up the navigation bar, and customizing CSS.

### Setting up SMTP{#smtp}

1. Edit the `/bitnami/mediawiki LocalSettings.php` configuration file.

2. Find the variable $wgSMTP and set it as follows:
2. Locate the variable $wgSMTP and configure it as follows:

```
$wgSMTP = array(
Expand All @@ -52,14 +52,14 @@ import Meta from './_include/mediawiki.md';
```


4. Find the following variables and set its values to the sender's email address.
4. Locate the following variables and set their values to the sender's email address.

```
$wgEmergencyContact = "[email protected]";
$wgPasswordSender = "[email protected]";
```

5. After setting, restart the application to take effect.
5. After making these changes, restart the application for the settings to take effect.

## Configuration options{#configs}

Expand Down
16 changes: 8 additions & 8 deletions i18n/en/docusaurus-plugin-content-docs/current/apps/memcached.md
Original file line number Diff line number Diff line change
Expand Up @@ -15,17 +15,17 @@ import Meta from './_include/memcached.md';

### Initial setup{#wizard}

1. When completed installation of Memcached at **Websoft9 Console**, get the applicaiton's **Overview** and **Access** information from **My Apps**
1. When completing the installation of Memcached in the **Websoft9 Console**, get the applicaiton's **Overview** and **Access** information from **My Apps**

### Login to the Console

**Memcached-admin** is pre-built in this application orchestration but is not enabled by default. If you need to enable it, please refer to the following steps:
**Memcached-admin** is pre-built into this application orchestration but is not enabled by default. To enable it, following these steps:

1. Select **Websoft9 console > My apps > compose > Go to Edit Repository**.

2. Modify the Memcached docker-compose.yml.
2. Modify the Memcached `docker-compose.yml` file.

- Host ports in the ports element
- Update the host ports in the ports element
- Remove the profiles element.

3. After rebuilt the application, your can access the control panel through `http:/URL:port`.
Expand All @@ -43,7 +43,7 @@ import Meta from './_include/memcached.md';
^]'.
```

3. Connected successfully, the system enters the Memcached CLI, and inputs the command `stats`.
3. Once connected successfully, the system enters the Memcached CLI. Input the command `stats`.

```
$ stats
Expand All @@ -57,9 +57,9 @@ import Meta from './_include/memcached.md';

## Configuration options{#configs}

- Client command: [Memcached Commands](https://github.com/memcached/memcached/wiki/Commands) is run through Telnet.
- Server-side commands: `memcached -h`.
- Memcached-admin: You need to modify the compose file to enable it.
- Client command: Use [Memcached Commands](https://github.com/memcached/memcached/wiki/Commands) through Telnet.
- Server-side commands: Run `memcached -h`.
- Memcached-admin: Modify the compose file to enable it.

## Administer{#administrator}

Expand Down
10 changes: 5 additions & 5 deletions i18n/en/docusaurus-plugin-content-docs/current/apps/metabase.md
Original file line number Diff line number Diff line change
Expand Up @@ -17,23 +17,23 @@ import Meta from './_include/metabase.md';

1. Completed installation Metabase at Websoft9 console, get the applicaiton's overview and access credentials from **My Apps**

2. Access through URL and enter the login page.
2. Access the URL and enter the login page.

3. After successful login, follow the wizard. when enter **Add your data** step, it is recommended to select **I will add my data later**.
3. After successfully logging in, follow the wizard. When you reach the **Add your data** step, it is recommended to select **I will add my data later**.

4. After completing all the steps, login to the backend.
4. After completing all the steps, log in to the backend.
![](./assets/metabase-backend-websoft9.png)

### Add data source

After logining to the Metabase backend, click the icon in the upper right corner and select **Settings** to add a data source.
After logging in to the Metabase backend, click the icon in the upper right corner and select **Settings** to add a data source.

![](./assets/metabase-backendadmin-websoft9.png)

## Configuration options{#configs}

- SMTP: Click the icon in the upper right corner and selcet **Settings > General > email**
- Multilingual (✅) : Automatically selected when install.
- Multilingual (✅) : This option is automatically selected during installation.
- Multi-user (✅)
- [Matebase API](https://www.metabase.com/docs/latest/api-documentation.html)

Expand Down
Loading

0 comments on commit 2afa29c

Please sign in to comment.