IBX-9147: Symbol attribute type described in Developer Documentation

[julitafalcondusza]

Question	Answer
JIRA Ticket	(https://issues.ibexa.co/browse/IBX-9147)
Versions	4.6+

Symbol attribute type described in Developer Documentation

Preview:

• https://ez-systems-developer-documentation--2525.com.readthedocs.build/en/2525/pim/symbol_attribute_type/
• https://ez-systems-developer-documentation--2525.com.readthedocs.build/en/2525/search/criteria_reference/product_search_criteria/#product-search-criteria
• https://ez-systems-developer-documentation--2525.com.readthedocs.build/en/2525/search/criteria_reference/symbolattribute_criterion/

Checklist

• Text renders correctly
• Text has been checked with vale
• Description metadata is up to date
• Redirects cover removed/moved pages
• Code samples are working
• PHP code samples have been fixed with PHP CS fixer
• Added link to this PR in relevant JIRA ticket or code PR

[mnocon]

Thank you for preparing this!

I've left a couple of suggestions to make it clearer - but I believe it already includes all the neccessary parts, we just need to improve them a bit.

I cannot provide you with the PostgreSQL schema, we will need someone from the backend team for that.

[adamwojs]

I cannot provide you with the PostgreSQL schema, we will need someone from the backend team for that.

I will take care of it.

[github-actions]

code_samples/ change report

Before (on target branch)	After (in current PR)
code_samples/pim/Symbol/Format/Checksum/LuhnChecksum.php	code_samples/pim/Symbol/Format/Checksum/LuhnChecksum.php
	docs/pim/symbol_attribute_type.md@119:``` php docs/pim/symbol_attribute_type.md@120:[[= include_file('code_samples/pim/Symbol/Format/Checksum/LuhnChecksum.php') =]] docs/pim/symbol_attribute_type.md@121:``` 001⫶ 002⫶ 003⫶declare(strict_types=1); 004⫶ 005⫶namespace App\PIM\Symbol\Format\Checksum; 006⫶ 007⫶use Ibexa\Contracts\ProductCatalog\Values\AttributeDefinitionInterface; 008⫶use Ibexa\Contracts\ProductCatalogSymbolAttribute\Value\ChecksumInterface; 009⫶ 010⫶final class LuhnChecksum implements ChecksumInterface 011⫶{ 012⫶ public function validate(AttributeDefinitionInterface $attributeDefinition, string $value): bool 013⫶ { 014⫶ $digits = $this->getDigits($value); 015⫶ 016⫶ $count = count($digits); 017⫶ $total = 0; 018⫶ for ($i = $count - 2; $i >= 0; $i -= 2) { 019⫶ $digit = $digits[$i]; 020⫶ if ($i % 2 === 0) { 021⫶ $digit *= 2; 022⫶ } 023⫶ 024⫶ $total += $digit > 9 ? $digit - 9 : $digit; 025⫶ } 026⫶ 027⫶ $checksum = $digits[$count - 1]; 028⫶ 029⫶ return $total + $checksum === 0; 030⫶ } 031⫶ 032⫶ /** 033⫶ * Returns an array of digits from the given value (skipping any formatting characters). 034⫶ * 035⫶ * @return int[] 036⫶ */ 037⫶ private function getDigits(string $value): array 038⫶ { 039⫶ $chars = array_filter( 040⫶ str_split($value), 041⫶ static fn (string $char): bool => $char !== '-' 042⫶ ); 043⫶ 044⫶ return array_map('intval', array_values($chars)); 045⫶ } 046⫶}

Download colorized diff