Described virtual products and added an example creating product type with PHP API

[mnocon]

Doc for https://ibexa.atlassian.net/browse/IBX-10630

Status: waiting for 4.6 release

Turns out we didn't have virtual products mentioned at all in the doc, so I'm adding a mention to the product guide.

Code tested locally:

[github-actions]

Preview of modified files

Preview of modified Markdown:

• docs/pim/pim_guide.md
• docs/pim/product_api.md

[mnocon]

Note to self: on upmerge, this should be ibexa_string

[adriendupuis]

I wouldn't straiten developers to virtual as being only digital.

[dabrt]

I would add a link somewhere that binds dev doc with user doc by pointing to:
https://doc.ibexa.co/projects/userguide/en/latest/pim/create_virtual_product/

[adriendupuis]

I would add a link somewhere that binds dev doc with user doc by pointing to: https://doc.ibexa.co/projects/userguide/en/latest/pim/create_virtual_product/

@mnocon And I discover that the user doc doesn't have the "digital" bias and even quotes examples I was thinking of. 😉

[github-actions]

code_samples/ change report

Before (on target branch)	After (in current PR)
code_samples/api/product_catalog/src/Command/ProductTypeCommand.php	code_samples/api/product_catalog/src/Command/ProductTypeCommand.php
docs/pim/product_api.md@110:``` php docs/pim/product_api.md@111:[[= include_file('code_samples/api/product_catalog/src/Command/ProductTypeCommand.php', 43, 44) =]] docs/pim/product_api.md@112:```	docs/pim/product_api.md@114:``` php docs/pim/product_api.md@115:[[= include_file('code_samples/api/product_catalog/src/Command/ProductTypeCommand.php', 62, 66) =]] docs/pim/product_api.md@116:``` 001⫶ $productTypeCreateStruct = $this->localProductTypeService->newProductTypeCreateStruct( 002⫶ 'digital_product', 003⫶ 'eng-GB' 004⫶ ); docs/pim/product_api.md@120:``` php docs/pim/product_api.md@121:[[= include_file('code_samples/api/product_catalog/src/Command/ProductTypeCommand.php', 67, 71) =]] docs/pim/product_api.md@122:``` 001⫶ $productTypeCreateStruct->setNames([ 002⫶ 'eng-GB' => 'Digital Product', 003⫶ 'pol-PL' => 'Produkt Cyfrowy', 004⫶ ]); docs/pim/product_api.md@126:``` php docs/pim/product_api.md@127:[[= include_file('code_samples/api/product_catalog/src/Command/ProductTypeCommand.php', 72, 73) =]] docs/pim/product_api.md@128:``` 001⫶ $productTypeCreateStruct->setVirtual(true); docs/pim/product_api.md@135:``` php docs/pim/product_api.md@136:[[= include_file('code_samples/api/product_catalog/src/Command/ProductTypeCommand.php', 76, 83) =]] docs/pim/product_api.md@137:``` 001⫶ $marketingDescriptionFieldDefinition = $this->contentTypeService->newFieldDefinitionCreateStruct( 002⫶ 'marketing_description', 003⫶ 'ezstring' 004⫶ ); 005⫶ $marketingDescriptionFieldDefinition->names = ['eng-GB' => 'Marketing Description']; 006⫶ $marketingDescriptionFieldDefinition->position = 100; 007⫶ $contentTypeCreateStruct->addFieldDefinition($marketingDescriptionFieldDefinition); docs/pim/product_api.md@145:``` php docs/pim/product_api.md@146:[[= include_file('code_samples/api/product_catalog/src/Command/ProductTypeCommand.php', 84, 85) =]] docs/pim/product_api.md@147:``` 001⫶ $sizeAttribute = $this->attributeDefinitionService->getAttributeDefinition('size'); docs/pim/product_api.md@151:``` php docs/pim/product_api.md@152:[[= include_file('code_samples/api/product_catalog/src/Command/ProductTypeCommand.php', 86, 93) =]] docs/pim/product_api.md@153:``` 001⫶ $attributeAssignment = new AssignAttributeDefinitionStruct( 002⫶ $sizeAttribute, 003⫶ false, 004⫶ false 005⫶ ); 006⫶ 007⫶ $productTypeCreateStruct->setAssignedAttributesDefinitions([$attributeAssignment]); docs/pim/product_api.md@161:``` php docs/pim/product_api.md@162:[[= include_file('code_samples/api/product_catalog/src/Command/ProductTypeCommand.php', 94, 95) =]] docs/pim/product_api.md@163:``` 001⫶ $newProductType = $this->localProductTypeService->createProductType($productTypeCreateStruct); docs/pim/product_api.md@169:``` php docs/pim/product_api.md@170:[[= include_file('code_samples/api/product_catalog/src/Command/ProductTypeCommand.php', 96, 97) =]] docs/pim/product_api.md@171:```
001⫶ $productType = $this->productTypeService->getProductType($productTypeIdentifier);	001⫶ $productType = $this->productTypeService->getProductType($productTypeIdentifier);
docs/pim/product_api.md@116:``` php docs/pim/product_api.md@117:[[= include_file('code_samples/api/product_catalog/src/Command/ProductTypeCommand.php', 47, 52) =]] docs/pim/product_api.md@118:```	docs/pim/product_api.md@175:``` php docs/pim/product_api.md@176:[[= include_file('code_samples/api/product_catalog/src/Command/ProductTypeCommand.php', 100, 105) =]] docs/pim/product_api.md@177:```
001⫶ $productTypes = $this->productTypeService->findProductTypes(); 002⫶ 003⫶ foreach ($productTypes as $productType) { 004⫶ $output->writeln($productType->getName() . ' with identifier ' . $productType->getIdentifier()); 005⫶ }	001⫶ $productTypes = $this->productTypeService->findProductTypes(); 002⫶ 003⫶ foreach ($productTypes as $productType) { 004⫶ $output->writeln($productType->getName() . ' with identifier ' . $productType->getIdentifier()); 005⫶ }

Download colorized diff