### Author:  [@tk-fuse](https://forum.ficusonline.com/u/tk-fuse)
#### Post date: [2020 年 7 月 17 日午後 1:57 UTC](https://forum.ficusonline.com/t/topic/380/4 "2020-07-17T13:57:50Z")
**Symfonyデバックモードによる以下メッセージの非表示対応**
> Enabling the “sensio\_framework\_extra.router.annotations” configuration is deprecated since version 5.2. Set it to false and use the “Symfony\Component\Routing\Annotation\Route” annotation from Symfony itself
>
コンテナ内で設定ファイル **config.yml** に無効化するセクションを追加
```bash
# nano app/config/config.yml
```
```auto
sensio_framework_extra:
router:
annotations: false
```
---
### Author:  [@tk-fuse](https://forum.ficusonline.com/u/tk-fuse)
#### Post date: [2021 年 1 月 5 日午前 6:25 UTC](https://forum.ficusonline.com/t/topic/380/5 "2021-01-05T06:25:19Z")
### Webhooks vs APIs(application programming interfaces) — What’s The Difference?
**Stripe** （支払いサービス）を例に、 **API** と **Webhook** の違いを説明
> **[Webhook.net](https://webhook.net)**
>
> Webhooks: The Definitive Guide (2022)
データプル型のAPIに対し、Webhookはデータプッシュ型
多くのイベント発生時や、より詳細なデータを取得する場合などにはAPIが有利。
**Stripe**
> **[Stripe | 収益向上のための金融インフラ](https://stripe.com/jp)**
>
> Stripe は、あらゆる規模や業種のビジネスにおける決済の受け入れ、柔軟な請求モデルの構築、および資金移動の管理を支援する、金融サービスプラットフォームです。
**Prestashop Stripe モジュール**
[https://addons.prestashop.com/en/payment-card-wallet/24922-stripe-official-sca-ready.html](https://addons.prestashop.com/en/payment-card-wallet/24922-stripe-official-sca-ready.html)
---
### Author:  [@tk-fuse](https://forum.ficusonline.com/u/tk-fuse)
#### Post date: [2021 年 12 月 14 日午前 5:56 UTC](https://forum.ficusonline.com/t/topic/380/6 "2021-12-14T05:56:30Z")
## コマンドによるキャッシュクリア
コンテナ内で以下フォルダ削除
```auto
$ docker exec -ti prestashop-fpm bash
# rm -r var/cache/prod
```
または、 **`bin/console`** コマンドによりキャッシュクリア`(--env=prod or --env=dev)`
```auto
# bin/console cache:clear --env=prod
```
**`bin/console` コマンド一覧**
```auto
# bin/console list
Symfony 3.4.49 (kernel: app, env: dev, debug: true)
Usage:
command [options] [arguments]
Options:
-h, --help Display this help message
-q, --quiet Do not output any message
-V, --version Display this application version
--ansi Force ANSI output
--no-ansi Disable ANSI output
-n, --no-interaction Do not ask any interactive question
-e, --env=ENV The Environment name. [default: "dev"]
--no-debug Switches off debug mode.
-v|vv|vvv, --verbose Increase the verbosity of messages: 1 for normal output, 2 for more verbose output and 3 for debug
Available commands:
about Displays information about the current project
help Displays help for a command
list Lists commands
assets
assets:install Installs bundles web assets under a public directory
cache
cache:clear Clears the cache
cache:pool:clear Clears cache pools
cache:pool:prune Prunes cache pools
cache:warmup Warms up an empty cache
config
config:dump-reference Dumps the default configuration for an extension
debug
debug:autowiring Lists classes/interfaces you can use for autowiring
debug:config Dumps the current configuration for an extension
debug:container Displays current services for an application
debug:event-dispatcher Displays configured listeners for an application
debug:form Displays form type information
debug:router Displays current routes for an application
debug:swiftmailer Displays current mailers for an application
debug:tactician
debug:translation Displays translation messages information
debug:twig Shows a list of twig functions, filters, globals and tests
doctrine
doctrine:cache:clear-collection-region Clear a second-level cache collection region
doctrine:cache:clear-entity-region Clear a second-level cache entity region
doctrine:cache:clear-metadata Clears all metadata cache for an entity manager
doctrine:cache:clear-query Clears all query cache for an entity manager
doctrine:cache:clear-query-region Clear a second-level cache query region
doctrine:cache:clear-result Clears result cache for an entity manager
doctrine:cache:contains Check if a cache entry exists
doctrine:cache:delete Delete a cache entry
doctrine:cache:flush [doctrine:cache:clear] Flush a given cache
doctrine:cache:stats Get stats on a given cache provider
doctrine:database:create Creates the configured database
doctrine:database:drop Drops the configured database
doctrine:database:import Import SQL file(s) directly to Database.
doctrine:ensure-production-settings Verify that Doctrine is properly configured for a production environment
doctrine:generate:entities [generate:doctrine:entities] Generates entity classes and method stubs from your mapping information
doctrine:mapping:convert [orm:convert:mapping] Convert mapping information between supported formats
doctrine:mapping:import Imports mapping information from an existing database
doctrine:mapping:info
doctrine:query:dql Executes arbitrary DQL directly from the command line
doctrine:query:sql Executes arbitrary SQL directly from the command line.
doctrine:schema:create Executes (or dumps) the SQL needed to generate the database schema
doctrine:schema:drop Executes (or dumps) the SQL needed to drop the current database schema
doctrine:schema:update Executes (or dumps) the SQL needed to update the database schema to match the current mapping metadata
doctrine:schema:validate Validate the mapping files
fos
fos:js-routing:debug Displays currently exposed routes for an application
fos:js-routing:dump Dumps exposed routes to the filesystem
lint
lint:twig Lints a template and outputs encountered errors
lint:xliff Lints a XLIFF file and outputs encountered errors
lint:yaml Lints a file and outputs encountered errors
prestashop
prestashop:licenses:update Rewrite your licenses to be up-to-date
prestashop:linter:legacy-link Checks if _legacy_link is configured in BackOffice routes
prestashop:linter:naming-convention Checks if Back Office routes and controllers follow naming convention.
prestashop:linter:security-annotation Checks if Back Office route controllers has configured Security annotations.
prestashop:list:commands-and-queries Lists available CQRS commands and queries
prestashop:mail:generate Generate mail templates for a specified theme
prestashop:module Manage your modules via command line
prestashop:schema:update-without-foreign Update the database
prestashop:taxes:update-eu-tax-rule-groups Update EU Tax rule groups
prestashop:theme:enable Manage your themes via command line
prestashop:theme:export Create zip to distribute theme with its dependencies
prestashop:translation:find-duplicates Find duplicates of your translations
prestashop:update:configuration-file-hooks-listing Appends configuration file hooks list
prestashop:update:sql-upgrade-file-hooks-listing Adds sql to sql upgrade file which contains hook insert opeartion
router
router:match Helps debug routes by simulating a path info match
security
security:check Checks security issues in your project dependencies
security:encode-password Encodes a password.
server
server:log Starts a log server that displays logs in real time
server:run Runs a local web server
server:start Starts a local web server in the background
server:status Outputs the status of the local web server
server:stop Stops the local web server that was started with the server:start command
swiftmailer
swiftmailer:email:send Send simple email message
swiftmailer:spool:send Sends emails from the spool
translation
translation:update Updates the translation file
```
---
### Author:  [@tk-fuse](https://forum.ficusonline.com/u/tk-fuse)
#### Post date: [2022 年 3 月 15 日午前 7:33 UTC](https://forum.ficusonline.com/t/topic/380/7 "2022-03-15T07:33:37Z")
### テンプレートのカスタマイズ
**テーマのテンプレートディレクトリ**
`themes/classic/templates/_partials`
テンプレート編集後は管理画面から
`Advanced Parameters ---> Performance` からキャッシュをクリアすることで変更内容が反映されます。
**ex) Footerの編集**
```auto
# nano themes/classic/templates/_partials/footer.tpl
{l s='%copyright% %year% - Ecommerce software by %prestashop%' sprintf=['%prestashop%' => 'PrestaShop™', '%year%' => 'Y'|date, '%copyright%' => '©'] d='Shop.Theme.Global'}
```
---
### Author:  [@tk-fuse](https://forum.ficusonline.com/u/tk-fuse)
#### Post date: [2022 年 3 月 22 日午前 9:12 UTC](https://forum.ficusonline.com/t/topic/380/8 "2022-03-22T09:12:56Z")
### 通貨レートアップデート
[https://www.prestashop.com/forums/topic/1012820-solved-create-a-cronjob-to-auto-update-exchange-rate/](https://www.prestashop.com/forums/topic/1012820-solved-create-a-cronjob-to-auto-update-exchange-rate/)
モジュールによる通貨レートのアップデートではなく、ホストマシンのクローンジョブで対応。以下のコマンドをクローンジョブに追加。
```auto
# php /var/www/html/admin/cron_currency_rates.php secure_key=displayed_the_correct_secure_key
```
**`$secureKey`** は以下ファイルの一部を変更(echoによる確認）し抽出。抽出後削除すること。
**`/var/www/html/admin/cron_currency_rates.php`**
```auto
if (isset($_GET['secure_key'])) {
$secureKey = md5(_COOKIE_KEY_.Configuration::get('PS_SHOP_NAME'));
echo $secureKey;
if (!empty($secureKey) && $secureKey === $_GET['secure_key']) {
$shop_ids = Shop::getCompleteListOfShopsID();
foreach ($shop_ids as $shop_id) {
Shop::setContext(Shop::CONTEXT_SHOP, (int)$shop_id);
Currency::refreshCurrencies();
}
}
}
```
secure\_key=xxxxx を適当に指定すると正しい$securekeyが表示されます。
```auto
# php /var/www/html/admin/cron_currency_rates.php secure_key=xxxxx
asd4567890jj
```
これをクローンジョブのsecure\_keyに指定します。
```auto
#Prestashop currency update schedule
* 2 * * * docker exec -u www-data prestashop-container php /var/www/html/admin/cron_currency_rates.php secure_key=asd4567890jj
```
> **[Pricing FAQ](https://devdocs.prestashop-project.org/1.7/faq/pricing/)**
>
> Learn how to extend, modify and test PrestaShop, create modules, themes, and more.
---
### Author:  [@tk-fuse](https://forum.ficusonline.com/u/tk-fuse)
#### Post date: [2022 年 3 月 22 日午前 11:17 UTC](https://forum.ficusonline.com/t/topic/380/9 "2022-03-22T11:17:07Z")
### ロケーションデータの挿入
ロケーションデータ **GeoLite2 City** を下記サイトからダウンロード
[https://www.maxmind.com/en/accounts/353548/geoip/downloads](https://www.maxmind.com/en/accounts/353548/geoip/downloads)
展開したファイル **`GeoLite2-City.mmdb`** を **`app/Resources/geoip`** へコピーして
**“Geolocation by IP address”** を有効にします。
---
### Author:  [@tk-fuse](https://forum.ficusonline.com/u/tk-fuse)
#### Post date: [2022 年 3 月 26 日午前 5:52 UTC](https://forum.ficusonline.com/t/topic/380/10 "2022-03-26T05:52:39Z")
### Gmail SMTPサーバの設定
テストメール送信時のバグ。Chromeの自動入力によるアカウントのパスワードでSMTPサーバにアクセスしているため。Chromeの自動入力設定を削除するか、自動入力されないアカウントで設定することにより回避。
>
>
> \### Prerequisites
>
> \- \[X\] I understand and accept the project's \[code of conduc…t\](https://github.com/PrestaShop/PrestaShop/blob/develop/CODE\_OF\_CONDUCT.md)
> \- \[X\] I have already \[searched in existing issues\](https://github.com/PrestaShop/PrestaShop/issues?q=is%3Aissue+label%3ABug) and found no previous report of this bug.
>
> \### Describe the bug and add screenshots
>
> Try to enable Google 2FA and generate an "App Password" for autenticate SMT email send with not secure app, insert the password created in prestashop SMTP field, this result in error sending email.
>
> \### Expected behavior
>
> PS must send email with SMTP app password setup and google 2fa enabled.
>
> \### Steps to reproduce
>
> 1. Go to you gmail account
> 2. Disable imap
> 3. Open account management
> 4. Enable 2FA
> 5. Create a new app password
> 6. Copy password secret
> 7. Update prestashop SMTP password field with the new one created (instead the account password)
> 8. Try to send email
>
> \### PrestaShop version(s) where the bug happened
>
> 1.7.6.9
>
> \### PHP version(s) where the bug happened
>
> 7.2
>
> \### If your bug is related to a module, specify its name and its version
>
> \_No response\_
---
### Author:  [@tk-fuse](https://forum.ficusonline.com/u/tk-fuse)
#### Post date: [2022 年 3 月 28 日午前 6:22 UTC](https://forum.ficusonline.com/t/topic/380/11 "2022-03-28T06:22:23Z")
### E-Mailテンプレートの編集
**ModernよりもClassicテーマの方がレイアウトが整然としていて見やすいです。**
> **[The Mail Template component](https://devdocs.prestashop-project.org/1.7/development/components/mail-templates/)**
>
> Learn how to extend, modify and test PrestaShop, create modules, themes, and more.
メールで使用される各テンプレートは、テーマ毎 `(Modern, Classic)` に **`mails/themes`** に纏められています。
**`mails/themes`** フォルダ内の各テーマの `twig` ファイルから、`html` または `txt` 形式のファイルが作成されます（この作成作業は、`管理画面のデザイン ---> Email Theme ---> Generate emails` から行うか、以下の`prestashop:mail:generate`でも可能です）。
### `prestashop:mail:generate`
> **[prestashop:mail:generate](https://devdocs.prestashop-project.org/1.7/development/components/console/prestashop-mail-generate/)**
>
> Generate email templates from layouts
```auto
# bin/console prestashop:mail:generate --help
Usage:
prestashop:mail:generate [options] [--] [] []
Arguments:
theme Theme to use for mail templates.
locale Which locale to use for the templates.
coreOutputFolder Output folder to export core templates.
modulesOutputFolder Output folder to export modules templates (by default same as core).
Options:
-o, --overwrite[=OVERWRITE] Overwrite existing templates [default: false]
-h, --help Display this help message
-q, --quiet Do not output any message
-V, --version Display this application version
--ansi Force ANSI output
--no-ansi Disable ANSI output
-n, --no-interaction Do not ask any interactive question
-e, --env=ENV The Environment name. [default: "dev"]
--no-debug Switches off debug mode.
-v|vv|vvv, --verbose Increase the verbosity of messages: 1 for normal output, 2 for more verbose output and 3 for debug
```
ロケールと上書きオプションを指定してジェネレートコマンドを実行
```auto
# bin/console prestashop:mail:generate -o true classic ja-JP
# bin/console prestashop:mail:generate -o true classic en-US
```
また、作成されたテーマごとのメール送信テストは、 `Email themes` から行うことが出来ます（選択したテーマでのみ送信テストが可能）。
* * *
作成されたテンプレートをさらに細かく編集したい場合には、以下翻訳メニューから行うことが出来ます。
`International ---> Translations ---> Modify Translations` から以下の項目を選択
**`Core emails`** から編集するテンプレートを選択
[https://www.prestashop.com/forums/topic/1061432-new-email-template-on-1784-error/](https://www.prestashop.com/forums/topic/1061432-new-email-template-on-1784-error/)
テンプレートの編集箇所が多い場合は、直接twigファイルを編集したほうが良いかもしれません。上記テンプレートの `{recycled_packaging_label} ` やフッター `prestashop` へのリンクを削除する場合は、メールコアの `order_conf` で該当する表の行を削除するか、
次のClassicテーマのtwigテンプレート
`mails/themes/classic/conponents/footer.html.twig`
`mails/themes/classic/core/order_conf.html.twig`
から該当箇所を削除し、以下のメニュー画面に従って言語毎に再作成します（編集後、 **所有権の修正** を忘れずに）。
* * *
### Gmail SMTPサーバによる送信メール内のイメージについて
>
* * *
### メール関連ファイル
コントローラ
`src/PrestaShopBundle/Controller/Admin/Configure/AdvancedParameters/EmailController.php`
管理画面メール設定ファイル
`src/PrestaShopBundle/Resources/config/routing/admin/configure/advanced_parameters/email.yml`
テンプレート設定ファイル
`src/PrestaShopBundle/Resources/config/services/core/mail_template.yml`
```auto
prestashop.core.mail_template.theme_folder_catalog:
class: 'PrestaShop\PrestaShop\Core\MailTemplate\FolderThemeCatalog'
arguments:
- '%mail_themes_dir%'
- '@prestashop.core.mail_template.theme_folder_scanner'
- '@prestashop.core.hook.dispatcher'
prestashop.core.mail_template.variables_builder:
class: 'PrestaShop\PrestaShop\Core\MailTemplate\Layout\LayoutVariablesBuilder'
arguments:
- '@prestashop.core.hook.dispatcher'
- '@prestashop.core.language.language_default_fonts_catalog'
- mailThemesUrl: "@=service('prestashop.adapter.legacy.context').getMailThemesUrl()"
```
上記 **`mailThemesUrl`** は、
`src/Adapter/LegacyContext.php`
```auto
/**
* Url to the mail themes folder
*
* @return string
*/
public function getMailThemesUrl()
{
return $this->tools->getShopDomainSsl(true) . __PS_BASE_URI__. $this->mailThemesUri;
}
```
管理画面メール設定テンプレートフォルダ
`src/PrestaShopBundle/Resources/views/Admin/Configure/AdvancedParameters/Email`
Twig Configration
`app/config/config.yml`
```auto
# Twig Configuration
twig:
autoescape: "name"
debug: "%kernel.debug%"
strict_variables: "%kernel.debug%"
form_themes:
- 'PrestaShopBundle:Admin/TwigTemplateForm:bootstrap_4_horizontal_layout.html.twig'
paths:
'%admin_page%/Product': Product
'%admin_page%/TwigTemplateForm': Twig
'%admin_page%/Common': Common
'%admin_page%/Configure/AdvancedParameters': AdvancedParameters
'%admin_page%/Configure/ShopParameters': ShopParameters
'%kernel.root_dir%/../modules': Modules
'%mail_themes_dir%': MailThemes
globals:
webpack_server: false
multistore_field_prefix: !php/const:PrestaShopBundle\Service\Form\MultistoreCheckboxEnabler::MULTISTORE_FIELD_PREFIX
```
* * *
送信メールテンプレート
`mails/themes/modern/core/order_conf.html.twig`
```auto
```
---
### Author:  [@tk-fuse](https://forum.ficusonline.com/u/tk-fuse)
#### Post date: [2022 年 3 月 29 日午前 11:51 UTC](https://forum.ficusonline.com/t/topic/380/12 "2022-03-29T11:51:13Z")
### ストアURL、ドメイン変更
**ストアURLとSEO対策**
**`Shop Parameters ---> Traffic & SEO ---> SEO & URLs`**
‼ **注）ドメインを変更する場合** は上記URLとdocker-composeファイル（または.env）で指定したPS\_DOMAINを変更します。
---
### Author:  [@tk-fuse](https://forum.ficusonline.com/u/tk-fuse)
#### Post date: [2022 年 3 月 29 日午前 11:55 UTC](https://forum.ficusonline.com/t/topic/380/13 "2022-03-29T11:55:40Z")
### Customer Reassurance Module
セキュリティ、デリバリー、リターンポリシーの設定
**`Modules ---> Module Manager ---> Theme Module ---> Customer Assurance`**
---
### Author:  [@tk-fuse](https://forum.ficusonline.com/u/tk-fuse)
#### Post date: [2022 年 3 月 30 日午前 2:21 UTC](https://forum.ficusonline.com/t/topic/380/14 "2022-03-30T02:21:58Z")
### 登録ユーザ住所・配送先住所：国・都市選択メニュー
住所登録の際の国・都市のプルダウン選択メニューに表示させる項目の追加
左下 **“Bulk actions”** ボタンにより、一覧表から選択した **国(Countries)・都市(States)** を **有効** または **無効** にします。
**`International ---> Locations ---> "Countries" or "States"`**
**Countries**
**States**
⚠
**注）日本の都道府県がISOコード別に二重で登録されているため、片方を無効化。**
---
### Author:  [@tk-fuse](https://forum.ficusonline.com/u/tk-fuse)
#### Post date: [2022 年 3 月 30 日午前 4:06 UTC](https://forum.ficusonline.com/t/topic/380/15 "2022-03-30T04:06:57Z")
### 日本語ローカライゼーション
**`Locarization ---> Languages ---> 日本語`**
**ISOコード** は **`jp`** ではなく **`ja`** にしないと日本語の翻訳データがダウンロード出来ません。
**日本語の翻訳データのダウンロード**
**`Locarization ---> Languages ---> Import a localization pack ---> Japan`**
で日本語翻訳データのインポート（税、単位、都市、通貨、言語をチェック）。
日本語翻訳文中の変数は **`%s`** で前後に半角スペースを挿入すること。
---
### Author:  [@tk-fuse](https://forum.ficusonline.com/u/tk-fuse)
#### Post date: [2022 年 3 月 30 日午後 2:51 UTC](https://forum.ficusonline.com/t/topic/380/16 "2022-03-30T14:51:33Z")
# File Structure
> **[File structure](https://devdocs.prestashop-project.org/1.7/development/architecture/file-structure/)**
>
> Learn how to extend, modify and test PrestaShop, create modules, themes, and more.
### /app
This directory contains the configuration for the bundles and the framework.
It contains the following subdirectories:
- `/config`: configuration files for database, parameters, services, etc.
- `/logs`: execution logs
- `/Resources`: different resources for the software, most notably the `/translations` subdirectory which contains translation resources for all the installed languages.
- `/test`: reserved
This directory also includes the `AppKernel.php` file, which configures the Symfony application.
### /controllers
Contains controllers – as in Model-View-Controller (or MVC), the software architecture used by PrestaShop. Each file controls a specific part of PrestaShop.
Controllers are separated in two directories:
- `/admin`: contains legacy controllers for the Back Office
- `/front`: contains controllers for the Front Office
### /mails
Contains all HTML and text templates for e-mails sent by PrestaShop. Each language has its specific folder, where you can manually edit their content if you wish. PrestaShop contains a tool to edit your e-mails, located in the back office, in the Localization \> Translation page.
Since 1.7.6 this directory also contains [Mail themes](https://devdocs.prestashop.com/1.7/development/components/mail-templates/).
### /modules
Contains all of PrestaShop’s modules, each in its own folder.
_If you wish to definitely remove a module, it is better to uninstall it from the back office._
### /src
Contains the new architecture files ( **Core** , **Adapter** and **PrestaShop Bundle** ). To learn more, see [Understanding the “src” folder](https://devdocs.prestashop.com/1.7/development/architecture/file-structure/understanding-src-folder/).
- **Core** : contains business logic classes
- **Adapter** : business logic classes that still depend on legacy framework (for instance: `Context`, `Dispatcher` or constants);
- **PrestaShopBundle** : classes that acts as a glue between PrestaShop classes and Symfony
* * *
# Symfony controllers & routing
> **[Symfony controllers & routing](https://devdocs.prestashop-project.org/1.7/development/architecture/modern/controller-routing/)**
>
> Learn how to extend, modify and test PrestaShop, create modules, themes, and more.
Read the Symfony documentation on [Controllers](https://symfony.com/doc/current/controller.html) and [Routing](https://symfony.com/doc/current/routing.html).
`src/PrestaShopBundle/Controller`
```auto
Controller/
└── Admin
├── Configure
│ ├── AdvancedParameters
│ └── ShopParameters
├── Improve
│ ├── Design
│ ├── International
│ ├── Modules
│ ├── Payment
│ └── Shipping
└── Sell
├── Catalog
├── Customers
├── CustomerService
├── Orders
└── Stats
```
## Routing in PrestaShop
Routes are responsible for mapping a controller action to an url, you can read more about routing in [symfony docs](https://symfony.com/doc/current/routing.html).
PrestaShop uses YAML files for service declaration and routing (NOT ANNOTATIONS).
Routes are declared in
`src/PrestaShopBundle/Resources/config/admin`
folder, following the menu organization.
The routing is organized as follows:
```auto
.
├── admin
│ ├── _common.yml
│ ├── configure
│ │ ├── advanced_parameters
│ │ ├── _configure.yml
│ │ └── shop_parameters
│ ├── improve
│ │ ├── design
│ │ ├── _improve.yml
│ │ ├── international
│ │ ├── modules
│ │ ├── payment
│ │ └── shipping
│ ├── _security.yml
│ └── sell
│ ├── catalog
│ ├── orders
│ ├── _sell.yml
│ └── stocks.yml
├── admin.yml
├── api
│ ├── attributes.yml
│ ├── categories.yml
│ ├── features.yml
│ ├── i18n.yml
│ ├── improve
│ │ └── design
│ ├── manufacturers.yml
│ ├── stock_movements.yml
│ ├── stocks.yml
│ ├── suppliers.yml
│ └── translations.yml
└── api.yml
```
* * *
# URI, ディレクトリ
>
> **[Constants and variables for Prestashop 1.7 \[PHP, Smarty, Javascript, Twig\]](https://myrosblog.com/2018/04/constants-and-variables-for-prestashop/)**
>
> Ever wondered what constant to use in your controllers? Is it \_PS\_ROOT\_DIR\_ or \_\_PS\_BASE\_URI\_\_? In smarty templates, would you go for {$urls.img\_dir} or {$img\_dir}? Which constant to use? What variable are available? This article walks you through...
| Name | Language | Example | Type | Front, back? |
| --- | --- | --- | --- | --- |
| `_PS_ROOT_DIR_` | PHP | /var/www/html/prestashop | full path | front + back |
| root\_url | Twig | /prefix/ | | |
| ` __PS_BASE_URI__ ` | PHP | /prefix/ | relative url | |
| baseAdminDir | Javascript | /prefix/admin-dev/ | | back |
| baseDir | Javascript | /prefix/ | | back |
| basename(PS\_ADMIN\_DIR) | PHP | admin-dev | folder name | back |
| prestashop.urls | Javascript | base\_url:‘’, current\_url:‘’, shop\_domain\_url:‘’, img\_ps\_url:‘’, img\_cat\_url:’’, … | | front |
| {$base\_url} | Smarty | [https://myshop.com/prefix/](https://myshop.com/prefix/) | full url | back |
| {$base\_url} | Smarty | | | |
| {$baseAdminUrl} | Smarty | /prefix/admin-dev/ | relative url | back |
| {$img\_base\_path} | Smarty | /admin-dev/ | | back |
| {$urls.base\_url} | Smarty | [https://myshop.com/prefix/](https://myshop.com/prefix/) | full url | front |
* * *
### 管理画面コントローラ
国
`controllers/admin/AdminCountriesController.php`
都市
`controllers/admin/AdminStatesController.php`
---
### Author:  [@tk-fuse](https://forum.ficusonline.com/u/tk-fuse)
#### Post date: [2022 年 3 月 31 日午前 5:21 UTC](https://forum.ficusonline.com/t/topic/380/17 "2022-03-31T05:21:03Z")
## PHP syntax check
> **[Basic checks](https://devdocs.prestashop-project.org/1.7/modules/testing/basic-checks/)**
>
> Learn how to extend, modify and test PrestaShop, create modules, themes, and more.
```auto
# php -l
Syntax check only (lint)
```
```auto
# find . -type f -name '*.php' ! -path "./vendor/*" ! -path "./tests/*" -exec php -l -n {} \; | (! grep -v "No syntax errors detected")
```
---
### Author:  [@tk-fuse](https://forum.ficusonline.com/u/tk-fuse)
#### Post date: [2022 年 4 月 1 日午前 10:50 UTC](https://forum.ficusonline.com/t/topic/380/18 "2022-04-01T10:50:27Z")
## Fixed
`classes/State.php`
`County ---> Country, Counties ---> Countries`
```auto
/**
* Has Countries.
*
* @param int $idState
*
* @return int
*/
public static function hasCountries($idState)
{
return count(Country::getCountries((int) $idState));
}
```
---
### Author:  [@tk-fuse](https://forum.ficusonline.com/u/tk-fuse)
#### Post date: [2022 年 4 月 3 日午前 2:14 UTC](https://forum.ficusonline.com/t/topic/380/19 "2022-04-03T02:14:56Z")
### 多言語対応
データベース上のルール
> **[Database](https://devdocs.prestashop-project.org/1.7/development/database/)**
>
> Learn how to extend, modify and test PrestaShop, create modules, themes, and more.
- Tables which contain translations must end with the `_lang` suffix. For instance, `ps_product_lang` contains all the translations for the `ps_product` table.
- Use the `id_lang` field to store the language associated with a record.
---
### Author:  [@tk-fuse](https://forum.ficusonline.com/u/tk-fuse)
#### Post date: [2022 年 4 月 4 日午後 2:22 UTC](https://forum.ficusonline.com/t/topic/380/20 "2022-04-04T14:22:03Z")
### SQLテーブルデータ一覧
> **[Database structure](https://devdocs.prestashop-project.org/1.7/development/database/structure/)**
>
> Learn how to extend, modify and test PrestaShop, create modules, themes, and more.
> **[Db class](https://devdocs.prestashop-project.org/1.7/development/components/database/db/)**
>
> Learn how to extend, modify and test PrestaShop, create modules, themes, and more.
テーブルの追加・編集は以下sqlデータを参照のこと（自動インストール後はinstallディレクトリは削除されます）。
[https://github.com/PrestaShop/PrestaShop/blob/1.7.8.x/install-dev/data/db\_structure.sql](https://github.com/PrestaShop/PrestaShop/blob/1.7.8.x/install-dev/data/db_structure.sql)
**テーブルコンテンツ**
[https://github.com/PrestaShop/PrestaShop/tree/1.7.8.x/install-dev/data/xml](https://github.com/PrestaShop/PrestaShop/tree/1.7.8.x/install-dev/data/xml)
**`テーブル Country`**
```auto
/* Country specific data */
CREATE TABLE `PREFIX_country` (
`id_country` int(10) unsigned NOT NULL auto_increment,
`id_zone` int(10) unsigned NOT NULL,
`id_currency` int(10) unsigned NOT NULL DEFAULT '0',
`iso_code` varchar(3) NOT NULL,
`call_prefix` int(10) NOT NULL DEFAULT '0',
`active` tinyint(1) unsigned NOT NULL DEFAULT '0',
`contains_states` tinyint(1) NOT NULL DEFAULT '0',
`need_identification_number` tinyint(1) NOT NULL DEFAULT '0',
`need_zip_code` tinyint(1) NOT NULL DEFAULT '1',
`zip_code_format` varchar(12) NOT NULL DEFAULT '',
`display_tax_label` BOOLEAN NOT NULL,
PRIMARY KEY (`id_country`),
KEY `country_iso_code` (`iso_code`),
KEY `country_` (`id_zone`)
) ENGINE=ENGINE_TYPE DEFAULT CHARSET=utf8mb4 COLLATION;
/* Localized country information */
CREATE TABLE `PREFIX_country_lang` (
`id_country` int(10) unsigned NOT NULL,
`id_lang` int(10) unsigned NOT NULL,
`name` varchar(64) NOT NULL,
PRIMARY KEY (`id_country`, `id_lang`)
) ENGINE=ENGINE_TYPE DEFAULT CHARSET=utf8mb4 COLLATION;
```
**`テーブル State`**
```auto
/* State localization info */
CREATE TABLE `PREFIX_state` (
`id_state` int(10) unsigned NOT NULL auto_increment,
`id_country` int(11) unsigned NOT NULL,
`id_zone` int(11) unsigned NOT NULL,
`name` varchar(64) NOT NULL,
`iso_code` varchar(7) NOT NULL,
`tax_behavior` smallint(1) NOT NULL DEFAULT '0',
`active` tinyint(1) NOT NULL DEFAULT '0',
PRIMARY KEY (`id_state`),
KEY `id_country` (`id_country`),
KEY `name` (`name`),
KEY `id_zone` (`id_zone`)
) ENGINE=ENGINE_TYPE DEFAULT CHARSET=utf8mb4 COLLATION;
```
上記初期テーブル以外のテーブルは **Doctrine** により作成されます。
> **[Doctrine: PHP Open Source Project](https://www.doctrine-project.org/)**
>
> The Doctrine Project is an open-source PHP project that is home to home to several PHP libraries primarily focused on database storage and object mapping. The core projects are the Object Relational Mapper (ORM) and the Database Abstraction Layer...
**関連ディレクトリ**
`src/PrestaShopBundle/Entity/`
[次のページ](https://forum.ficusonline.com/t/topic/380.md?page=2)
\](https://reviewable.io/reviews/prestashopcorp/ps\_mbo/89)
モジュールセレクション：modules/addons/modules/catalog/selection、
テーマ一覧：modules/addons/themes/catalog
"Recommended Modules and Services"ボタンなどでの表示エラー
**\<原因1：doctrineマッピングエラー\>**
### Entities Mapping
| Class | Mapping errors |
| --- | --- |
| PrestaShopBundle\Entity\Tab | \* The association PrestaShopBundle\Entity\Tab#tabLangs refers to the owning side field PrestaShopBundle\Entity\TabLang#tab which does not exist. |
**\<対策：以下ファイルの該当箇所を修正\>**
```auto
# nano src/PrestaShopBundle/Entity/TabLang.php
```
**private $id —\> private $tab** へ修正
```php
class TabLang
{
/**
* @ORM\Id
* @ORM\ManyToOne(targetEntity="PrestaShopBundle\Entity\Tab", inversedBy="tabLangs")
* @ORM\JoinColumn(name="id_tab", referencedColumnName="id_tab", nullable=false)
*/
private $tab;
.......
.......
```
### ＜2021/06/11 更新＞エラー対応
[https://www.prestashop.com/forums/topic/1028687-have-trouble-connecting-to-addons/](https://www.prestashop.com/forums/topic/1028687-have-trouble-connecting-to-addons/)
[https://www.prestashop.com/forums/topic/1030080-theme-catalog-error/?tab=comments#comment-3259123](https://www.prestashop.com/forums/topic/1030080-theme-catalog-error/?tab=comments#comment-3259123)
`/modules/ps_mbo/src/ExternalContentProvider/ExternalContentProvider.php`
**0.6 —\> 20** へ変更。
```auto
class ExternalContentProvider implements ExternalContentProviderInterface
{
.....
const TIMEOUT_SECONDS = 20;
.....
```
---
**Symfonyデバックモードによる以下メッセージの非表示対応**
> Enabling the “sensio\_framework\_extra.router.annotations” configuration is deprecated since version 5.2. Set it to false and use the “Symfony\Component\Routing\Annotation\Route” annotation from Symfony itself
>