Skip to content

Commit

Permalink
feat: add troubleshooting section with create trigger problem (#9)
Browse files Browse the repository at this point in the history
  • Loading branch information
anoziere authored Nov 22, 2024
1 parent aaef002 commit 2b0999e
Show file tree
Hide file tree
Showing 6 changed files with 53 additions and 3 deletions.
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.


0 comments on commit 2b0999e

Please sign in to comment.