Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

feat: add troubleshooting section with create trigger problem #9

Merged
merged 1 commit into from
Nov 22, 2024
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 2 additions & 0 deletions docs/getting_started/Installation.md
Original file line number Diff line number Diff line change
Expand Up @@ -46,3 +46,5 @@ php Thelia admin:create
### Require existing modules
If you want to add a module made by our community you can browse [this](../../modules) list and execute the `composer require` command attached to it to download it.
After that you can enable and disable the module in the modules pages in your store back-office.

-----
2 changes: 1 addition & 1 deletion docs/getting_started/apache_configuration.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
---
title: Apache configuration
sidebar_position: 4
sidebar_position: 3
---

Only the ```web``` directory has to be accessible with apache, you can configure your vhost like this :
Expand Down
2 changes: 1 addition & 1 deletion docs/getting_started/docker.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
---
title: Dockerize your Thelia
sidebar_position: 6
sidebar_position: 4
---

A docker configuration is provided in the repository of Thelia. It uses docker-compose.
Expand Down
2 changes: 1 addition & 1 deletion docs/getting_started/nginx_configuration.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
---
title: Nginx configuration
sidebar_position: 5
sidebar_position: 2
---

Only the ```web``` directory has to be accessible :
Expand Down
4 changes: 4 additions & 0 deletions docs/getting_started/troubleshooting/_category_.json
Original file line number Diff line number Diff line change
@@ -0,0 +1,4 @@
{
"label": "Troubleshooting",
"position": 6
}
Original file line number Diff line number Diff line change
@@ -0,0 +1,44 @@
---
title: Trigger Creation Fails
sidebar_position: 1
---

When installing Thelia on a shared hosting environment, you might encounter an issue during the creation of the trigger `remove_free_text_feature_av`.

### Error Details

The following error message may appear:

```sql
Error: #1142 - The 'TRIGGER' command is denied to user 'sun_temp_1'@'od-8308ad.infomaniak.ch' on table 'feature_product'
```
### Cause

This issue is caused by insufficient database permissions for the user. Shared hosting environments often restrict the use of advanced features such as triggers. This limitation is not specific, might also occur with other hosting providers.

### Workaround

If trigger creation is not allowed:

1. Contact your hosting provider to verify if trigger permissions can be granted for your database user.
2. Alternatively, consider switching to a VPS or dedicated server where you have full control over database permissions
3. A workaround is to manually run the following SQL query periodically (e.g., via a cron job) to clean up the `feature_av` table:

```sql
DELETE FROM `feature_av`
WHERE `id` IN (
SELECT `feature_av_id`
FROM `feature_product`
WHERE `is_free_text` = 1
AND `feature_av_id` NOT IN (
SELECT `feature_av_id`
FROM `feature_product`
)
);
```

### Impact

This trigger is used to clean up the associated `feature_av` entries when a `feature_product` is deleted. The inability to create this trigger does not impact Thelia's functionality.


Loading