← All changes | app/Services/Integrations/FluentCRM/CrmContactService.php +72 -0 2.4.0 → 2.5.0 View file →

		@@ -228,8 +228,80 @@
228	228	'title' => $item->title,
229	229	];
230	230	}
231	231
	232	+ /**
	233	+ * The contact a note can be copied to, or null when FluentCRM is inactive,
	234	+ * the email has no contact, or the current user cannot manage contacts.
	235	+ *
	236	+ * @param string $email
	237	+ * @return array|null {contact_id, name, profile_url}
	238	+ */
	239	+ public static function getNoteTarget($email)
	240	+ {
	241	+ if (!self::canWriteNotes()) {
	242	+ return null;
	243	+ }
	244	+
	245	+ $contact = self::getContact($email);
	246	+
	247	+ if (!$contact) {
	248	+ return null;
	249	+ }
	250	+
	251	+ return [
	252	+ 'contact_id' => (int) $contact->id,
	253	+ 'name' => trim((string) $contact->full_name) ?: (string) $contact->email,
	254	+ 'profile_url' => fluentcrm_menu_url_base() . 'subscribers/' . $contact->id,
	255	+ ];
	256	+ }
	257	+
	258	+ /**
	259	+ * Add a note to the contact's FluentCRM profile, as FluentCRM's own
	260	+ * "Add note" does: same permission, same sanitizer, same hook.
	261	+ *
	262	+ * @param string $email
	263	+ * @param string $title Plain text.
	264	+ * @param string $description HTML. Passed through wp_kses_post.
	265	+ * @param string $type A FluentCRM activity type (fluentcrm_activity_types()).
	266	+ * @return int|\WP_Error The new note id.
	267	+ */
	268	+ public static function addContactNote($email, $title, $description, $type = 'note')
	269	+ {
	270	+ if (!self::canWriteNotes()) {
	271	+ return new \WP_Error('crm_permission', __('You do not have permission to add notes to CRM contacts.', 'fluent-booking'));
	272	+ }
	273	+
	274	+ $contact = self::getContact($email);
	275	+
	276	+ if (!$contact) {
	277	+ return new \WP_Error('crm_contact_not_found', __('No CRM contact found for this booking.', 'fluent-booking'));
	278	+ }
	279	+
	280	+ $data = \FluentCrm\App\Services\Sanitize::contactNote([
	281	+ 'subscriber_id' => (int) $contact->id,
	282	+ 'title' => (string) $title,
	283	+ 'description' => (string) $description,
	284	+ 'type' => $type,
	285	+ 'created_at' => current_time('mysql'),
	286	+ ]);
	287	+
	288	+ $data['created_by'] = get_current_user_id();
	289	+
	290	+ $note = \FluentCrm\App\Models\SubscriberNote::create($data);
	291	+
	292	+ // phpcs:ignore WordPress.NamingConventions.PrefixAllGlobals.NonPrefixedHooknameFound -- FluentCRM's own hook, fired so CRM automations see a note added from here like one added in the CRM
	293	+ do_action('fluent_crm/note_added', $note, $contact, $data);
	294	+
	295	+ return (int) $note->id;
	296	+ }
	297	+
	298	+ private static function canWriteNotes()
	299	+ {
	300	+ return self::isActive()
	301	+ && \FluentCrm\App\Services\PermissionManager::currentUserCan('fcrm_manage_contacts');
	302	+ }
	303	+
232	304	private static function getContact($email)
233	305	{
234	306	if (!self::isActive() || !$email) {
235	307	return null;