(feat): termdata

[ictbeheer]

This pull request refactors how meta fields are loaded for data objects, introducing a reusable trait to centralize and simplify meta loading logic. It also adds flexibility to taxonomy attribute handling and improves type compatibility for meta operations. The main changes are grouped below:

Meta loading refactor and code reuse:

• Introduced a new HasMeta trait (src/Traits/HasMeta.php) that encapsulates the logic for loading meta fields, determining meta prefixes, and resolving IDs for both posts and terms. This trait is now used by both PostData and TermData, removing duplicated code and improving maintainability.
• Updated PostData and TermData to use the HasMeta trait, and refactored their constructors to call loadMeta() without requiring an explicit ID parameter. This centralizes meta-loading behavior and ensures consistency. [1] [2] [3]
• Removed the now-redundant meta loading and prefix methods from PostData, as this logic is handled by the new trait.

Attribute and type improvements:

• Enhanced the Terms attribute to accept a custom data class for term collection, increasing flexibility for term data mapping. The getValue method now uses the specified data class instead of being hardcoded to TermData. [1] [2]
• Updated the Meta attribute's getValue method to accept both string and integer post IDs, improving compatibility with different ID formats.

Other minor cleanup:

• Removed unused imports from PostData.php for clarity.

[github-actions]

Coverage report for commit: 762360f
File: coverage.xml

Cover ┌─────────────────────────┐ Freq.
   0% │ ███████████████████████ │ 73.3%
  10% │ ███░░░░░░░░░░░░░░░░░░░░ │  6.7%
  20% │ ░░░░░░░░░░░░░░░░░░░░░░░ │  0.0%
  30% │ ░░░░░░░░░░░░░░░░░░░░░░░ │  0.0%
  40% │ ███░░░░░░░░░░░░░░░░░░░░ │  6.7%
  50% │ ░░░░░░░░░░░░░░░░░░░░░░░ │  0.0%
  60% │ ░░░░░░░░░░░░░░░░░░░░░░░ │  0.0%
  70% │ ░░░░░░░░░░░░░░░░░░░░░░░ │  0.0%
  80% │ ░░░░░░░░░░░░░░░░░░░░░░░ │  0.0%
  90% │ ░░░░░░░░░░░░░░░░░░░░░░░ │  0.0%
 100% │ █████░░░░░░░░░░░░░░░░░░ │ 13.3%
      └─────────────────────────┘
 *Legend:* █ = Current Distribution 

Summary - Lines: 11.30% | Methods: 5.88%

Files	Lines	Methods	Branches
src/Attributes
Meta.php	-	-	100.00%
MetaPrefix.php	-	-	100.00%
TaxonomyPrefix.php	-	-	100.00%
Terms.php	-	-	100.00%
src/Contracts
PostDataInterface.php	100.00%	100.00%	100.00%
src/Enums
PostStatus.php	-	-	100.00%
src
ImageData.php	-	-	100.00%
PostData.php	8.93%	3.85%	100.00%
TermData.php	-	-	100.00%
UserData.php	-	-	100.00%
src/Mappers
PostPrefixMapper.php	-	-	100.00%
UserPrefixMapper.php	-	-	100.00%
src/Normalizers
WPPostNormalizer.php	-	-	100.00%
src/Providers
DataServiceProvider.php	100.00%	100.00%	100.00%
src/Traits
HasMeta.php	36.00%	-	100.00%

_{🤖 comment via lucassabreu/comment-coverage-clover}

[mvdhoek1]

Goeie, dit om ACF niet te laten breken toch?

[ictbeheer]

Klopt, de werking van get_field is een beetje vreemd: https://www.advancedcustomfields.com/resources/get_field/#get-a-value-from-different-objects

[SimonvanWijhe]

Nog wel even een voorbeeld aan de README.md toevoegen.

[SimonvanWijhe]

postID() is hier niet helemaal juist. WordPress noemt dit $object_id https://developer.wordpress.org/reference/functions/get_metadata dus ik zou deze method objectID noemen.

[YvetteNikolov]

Jeej 🎉

Kun je de README updaten? En dan specifiek wat voorbeelden van hoe je het kan gebruiken in PHP / Blade templates voor de domme frontenders? https://github.com/yardinternet/yard-data#reading-terms-from-your-data-object