Skip to content

feat(#10662): document photo_field contact type property and profile photo display#2227

Draft
benkags wants to merge 1 commit into
medic:mainfrom
benkags:10662-profile-photo-docs
Draft

feat(#10662): document photo_field contact type property and profile photo display#2227
benkags wants to merge 1 commit into
medic:mainfrom
benkags:10662-profile-photo-docs

Conversation

@benkags

@benkags benkags commented Jul 8, 2026

Copy link
Copy Markdown
Contributor

Description

Documents the contact profile photo feature (medic/cht-core#10662, implemented in medic/cht-core#11087):

  • Contacts overview (contact-management/contacts.md): the profile header can display the contact's photo instead of the contact type icon.
  • contact_types reference (app-settings/hierarchy.md): new photo_field property — names the contact field holding the photo's filename; the matching user-file-<value> attachment is shown as a circular photo, falling back to the type icon. Defaults to photo.
  • Contact forms (forms/contact.md): how child contacts created within a place form get their own profile photos.

Draft until medic/cht-core#11087 merges. The "From 5.2.0" version references are placeholders and will be updated to the actual release before this is marked ready for review.

License

The software is provided under AGPL-3.0. Contributions to this project are accepted under the same license.

Document the new photo_field contact type property: the contact profile
header displays the photo stored in the contact's user-file-<value>
attachment, falling back to the type icon when no photo is present.
Covers the contacts overview, the contact_types reference, and how
child contacts created within a place form get their photos.

The feature is implemented in medic/cht-core#11087, which has not
merged yet. Version references ("From 5.2.0") must be updated to the
actual release before this is published.
@benkags benkags changed the title docs: display contact profile photo via photo_field (cht-core#10662) feat(#10662): document photo_field contact type property and profile photo display Jul 8, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant