sureforms / inc / compatibility / multilingual / multilingual-manager.php

multilingual-manager.php in SureForms – Contact Form Builder, AI Forms, Payment Form, Survey & Quiz 2.12.8, at inc/compatibility/multilingual/multilingual-manager.php

96 lines 2.4 KB

Raw Download Zip

1	<?php
2	/**
3	* Multilingual Manager.
4	*
5	* Resolves the active multilingual provider (WPML for v1). Returns Null_Provider when
6	* no supported multilingual plugin is active, so call sites can stay free of conditionals.
7	*
8	* @package sureforms.
9	* @since 2.11.0
10	*/
11
12	namespace SRFM\Inc\Compatibility\Multilingual;
13
14	use SRFM\Inc\Compatibility\Multilingual\Providers\Null_Provider;
15	use SRFM\Inc\Compatibility\Multilingual\Providers\Provider;
16	use SRFM\Inc\Compatibility\Multilingual\Providers\WPML_Provider;
17	use SRFM\Inc\Traits\Get_Instance;
18
19	if ( ! defined( 'ABSPATH' ) ) {
20	exit; // Exit if accessed directly.
21	}
22
23	/**
24	* Multilingual_Manager.
25	*
26	* Resolves the active multilingual provider (WPML for v1). Returns Null_Provider when
27	* no supported multilingual plugin is active.
28	*
29	* @since 2.11.0
30	*/
31	class Multilingual_Manager {
32	use Get_Instance;
33
34	/**
35	* Resolved provider instance.
36	*
37	* @since 2.11.0
38	* @var Provider
39	*/
40	private $provider;
41
42	/**
43	* Constructor. Resolves and caches the active multilingual provider.
44	*
45	* @since 2.11.0
46	*/
47	public function __construct() {
48	$this->provider = $this->resolve_provider();
49	}
50
51	/**
52	* Get the resolved multilingual provider.
53	*
54	* @since 2.11.0
55	* @return Provider Active provider instance, or Null_Provider when none is available.
56	*/
57	public function provider(): Provider {
58	return $this->provider;
59	}
60
61	/**
62	* Resolve which provider to use based on the active multilingual plugin.
63	*
64	* Resolution order:
65	* 1. WPML_Provider when WPML 4.5+ is active.
66	* 2. Null_Provider otherwise.
67	* 3. The `srfm_multilingual_provider` filter may override the default with any
68	* {@see Provider} implementation; non-conforming values are ignored.
69	*
70	* @since 2.11.0
71	* @return Provider Resolved provider instance.
72	*/
73	protected function resolve_provider(): Provider {
74	$wpml = new WPML_Provider();
75
76	$provider = $wpml->is_active() ? $wpml : new Null_Provider();
77
78	/**
79	* Filter the resolved multilingual provider.
80	*
81	* Third parties can return their own {@see Provider} implementation to
82	* replace SureForms' default resolution. Non-conforming return values are ignored.
83	*
84	* @since 2.11.0
85	* @param Provider $provider The resolved provider instance.
86	*/
87	$filtered = apply_filters( 'srfm_multilingual_provider', $provider );
88
89	if ( $filtered instanceof Provider ) {
90	return $filtered;
91	}
92
93	return $provider;
94	}
95	}
96