c64persian hat geschrieben: 06.08.2024 10:38
I also had a request that may not belong here. If possible, enable the English language in the user control panel
This is not possible at the moment.
Below is an example of creating a Persian checksum packet with FCHG.
I looked around the php-bb.ir forum and if I see it correctly, Meis@M is the administrator there. I also saw that you posted a topic for File Check there. So it would probably be easier for Meis@M if you linked him directly to this post here. If he has any questions, he can ask them directly here.
Example
1. Create a folder with the following structure:
Code: Alles auswählen
config/
filecheck_exceptions.txt
filecheck_hashgen_config.php
folder/
fa/
adm/
assets/
bin/
...
zip/
phpBB-3.3.12.zip
filecheck_hashgen.php
The contents of the folders and files are explained below:
2. The
filecheck_exceptions.txt must contain the following:
Code: Alles auswählen
ext/phpbb/viglink/language/fa/
language/fa/
styles/prosilver/theme/fa/
3. The
filecheck_hashgen_config.php must contain the following:
Code: Alles auswählen
<?php
/**
*
* phpBB File Check Hash Generator - Creates checksum packages for phpBB File Check
*
* @copyright (c) 2023 LukeWCS <phpBB.de>
* @license GNU General Public License, version 2 (GPL-2.0-only)
*
*/
# phpcs:set VariableAnalysis.CodeAnalysis.VariableAnalysis validUnusedVariableNames config
/*
The static configuration can be defined here, which does not change with new phpBB versions.
The dynamic configuration can then be passed via CLI. All config variables have the same name
as their associated CLI parameters.
Example:
config: 'source-1' => ''
CLI : --source-1=""
*/
$config = [
/*>
Primary source (ZIP or folder)
<*/
'source-1' => '',
/*>
Secondary source (ZIP or folder)
<*/
'source-2' => '',
/*>
The folder where the finished hash package ZIP will be created.
<*/
'export-dir' => '',
/*>
The folder within a ZIP, i.e. "phpBB3/". That could possibly change in 4.0.
<*/
'zip-root' => 'phpBB3/',
/*>
The label of the primary hash package. Required for various displays, including error messages.
This is also used by "phpBB File Check".
<*/
'source-1-label' => 'phpBB.com',
/*>
The label of the secondary hash package. Required for various displays, including error messages.
This is also used by "phpBB File Check".
<*/
'source-2-label' => 'php-bb.ir',
/*>
Text file in which one RegEx expression can be entered per line.
This file is only evaluated by "phpBB File Check" and is added to the hash package ZIP.
The file name in the hash package ZIP is changed to "filecheck_ignore.txt".
<*/
'ignore-file' => '',
/*>
Text file in which one file/folder exception can be entered per line.
This file is only evaluated by "phpBB File Check" and is added to the hash package ZIP.
The file name in the hash package ZIP is changed to "filecheck_exceptions.txt".
<*/
'exceptions-file' => 'config/filecheck_exceptions.txt',
/*>
The filename of the hash package ZIP to create, i.e. "phpBB_FileCheck_MD5_{PHPBB_VERSION}".
{PHPBB_VERSION} will be replaced with the phpBB version.
<*/
'hash-zip-name' => 'phpBB_FileCheck_MD5_{PHPBB_VERSION}_fa',
/*>
For the date display when checking the hash package ZIP.
<*/
'timezone-id' => 'Asia/Tehran',
];
# phpcs:set VariableAnalysis.CodeAnalysis.VariableAnalysis validUnusedVariableNames
4. The
fa folder consists of the Persian complete package and the Persian language package.
Actually, FCHG could also work directly with a Persian complete package, i.e. with a ZIP, but unfortunately that doesn't work for 2 reasons:
- In the Persian ZIP, the root path does not correspond to the standard
phpBB3.
- The Persian complete package does not contain everything, so a second package is necessary.
For these two reasons, the folder required for FCHG must be created manually as shown here. This means that these files must be unpacked into the
fa folder:
http://www.php-bb.ir/dl/phpBB3.3.12.zip
http://www.php-bb.ir/dl/persian_3_3_12.zip
The
fa folder must therefore contain exactly the same content as would be the case with a new Persian phpBB installation.
5.
phpBB-3.3.12.zip is the original phpBB.com package:
https://download.phpbb.com/pub/release/ ... 3.3.12.zip
The ZIP does not need to be unpacked, FCHG can work directly with this ZIP.
6.
filecheck_hashgen.php can be found in the new version 1.0.3 here:
https://github.com/LukeWCS/phpbb-file-check-hash-gen
7. Now everything is prepared and we can run FCHG:
Code: Alles auswählen
php filecheck_hashgen.php --source-1="zip/phpBB-3.3.12.zip" --source-2="folder/fa"
8. If everything has been prepared correctly, the result should look like this:
Code: Alles auswählen
phpBB File Check Hash Generator v1.0.3
======================================
Version primary : 3.3.12 (phpBB.com) ZIP
Version secondary : 3.3.12 (php-bb.ir) FOLDER
Checksums primary : 3861 (phpBB.com) -> filecheck_3.3.12.md5
Checksums secondary: 3982 (php-bb.ir)
Checksums diff : 121 (php-bb.ir) -> filecheck_3.3.12_diff.md5
Hash package ZIP : phpBB_FileCheck_MD5_3.3.12_fa.zip (112237 bytes)
Size Comp.Size Date Time File
-------------------------------------------------------------------
333776 108439 2024-08-07 17:55:02 filecheck_3.3.12.md5
8510 3353 2024-08-07 17:55:02 filecheck_3.3.12_diff.md5
71 57 2024-08-07 17:55:02 filecheck_exceptions.txt
-------------------------------------------------------------------
Finished! Run time: 1.156 seconds
Using this pattern, a new checksum package can then be created for each new phpBB version.
9. Automatic download of the correct checksum package:
FC can automatically download the checksum package from the server from version 1.4.0 onwards. To do this, you must adapt the file
filecheck_config.php accordingly. For this to work, a package archive must be available on php-bb.ir, similar to what is available on phpBB.de:
https://downloads.phpbb.de/pakete/deutsch/
This means that checksum packages must be created retrospectively. As far back as desired.
FC has helped us supporters several times to locate errors that we would otherwise have had difficulty or not found at all.
Whether phpBB.com also wants to offer FileCheck depends primarily on whether the phpBB.com supporters want it.