s="file">app/backend/migrations/__pycache__/__init__.cpython-39.pyc
Voir le fichier

+ 50 - 39
app/backend/models.py
Voir le fichier 

@@ -109,6 +109,8 @@ class Patient(models.Model):
109 109 
     birth_date = models.DateField(null=True)
110 110 
     age = models.IntegerField(null=True, blank=True)
111 111 
     idcard = models.CharField(max_length=20, null=True, blank=False)
112 
+    tel = models.CharField(max_length=100, null=True, blank=True)
113 
+    line_id = models.CharField(max_length=100, null=True, blank=True)
112 114 
     prefix = models.CharField(
113 115 
         max_length=30,
114 116 
         choices=GENDER_CHOICES,
 
@@ -148,51 +150,57 @@ class Patient(models.Model):
148 150 
     def nearby_from_db(self, dlimit):
149 151 
         bd = ""
150 152 
         temps = []
151 
-        for h0 in  Hospital.objects.all():
152 
-            p2 = (h0.geolocation.lat, h0.geolocation.lon)
153 
-            p1 = (self.geolocation.lat, self.geolocation.lon)
154 
-            d = round(hs.haversine(p1,p2), 2)
155 
-            if d < dlimit:
156 
-                #bd += f"<tr><td>{h0.title}</td><td>{d}km</td></tr>"
157 
-                temps.append({'title': h0.title, 'd': d, 'id': h0.id, 'beds': h0.free_beds()})
158 
-                #print(f"to {h0.title} => {hs.haversine(p1, p2)}km")
159 
-
160 
-        temps.sort(key= lambda s: s['d'], reverse=False)
161 
-        for t in temps:
162 
-            bd += f"<tr><td><a href='/admin/backend/hospital/{t['id']}/change/' target='_blank'>{t['title']}</a></td><td>{t['d']} km</td><td>{t['beds']}</td></tr>"
163 
-
164 
-        rt = f'''
165 
-<br>
166 
-        <table><thead><tr><th>Hospital</th><th>Distance</th><th>Free Beds</th></tr></thead>
167 
-        <tbody>
168 
-            {bd}
169 
-        </tbody>
170 
-        </table>
171 
-        '''
172 
-        return rt
153 
+        try:
154 
+            for h0 in  Hospital.objects.all():
155 
+                p2 = (h0.geolocation.lat, h0.geolocation.lon)
156 
+                p1 = (self.geolocation.lat, self.geolocation.lon)
157 
+                d = round(hs.haversine(p1,p2), 2)
158 
+                if d < dlimit:
159 
+                    #bd += f"<tr><td>{h0.title}</td><td>{d}km</td></tr>"
160 
+                    temps.append({'title': h0.title, 'd': d, 'id': h0.id, 'beds': h0.free_beds()})
161 
+                    #print(f"to {h0.title} => {hs.haversine(p1, p2)}km")
162 
+
163 
+            temps.sort(key= lambda s: s['d'], reverse=False)
164 
+            for t in temps:
165 
+                bd += f"<tr><td><a href='/admin/backend/hospital/{t['id']}/change/' target='_blank'>{t['title']}</a></td><td>{t['d']} km</td><td>{t['beds']}</td></tr>"
166 
+
167 
+            rt = f'''
168 
+    <br>
169 
+            <table><thead><tr><th>Hospital</th><th>Distance</th><th>Free Beds</th></tr></thead>
170 
+            <tbody>
171 
+                {bd}
172 
+            </tbody>
173 
+            </table>
174 
+            '''
175 
+            return rt
176 
+        except:
177 
+            return "-"
173 178
174 179 
     def nearby(self):
175 180 
         #self.nearby_from_db()
176 
-        r = gmaps.places_nearby(location=(self.geolocation.lat, self.geolocation.lon), type="hospital", radius=10000)
177 
-        bd = ""
178 
-        for r0 in r['results']:
179 
-            openh = "-"
180 
-            if 'opening_hours' in r0:
181 
-                openh = r0['opening_hours']['open_now']
182 
-            else:
181 
+        try:
182 
+            r = gmaps.places_nearby(location=(self.geolocation.lat, self.geolocation.lon), type="hospital", radius=10000)
183 
+            bd = ""
184 
+            for r0 in r['results']:
183 185 
                 openh = "-"
186 
+                if 'opening_hours' in r0:
187 
+                    openh = r0['opening_hours']['open_now']
188 
+                else:
189 
+                    openh = "-"
184 190
185 
-            bd += f"<tr><td>{r0['name']}</td><td>{openh}</td><td>{r0['vicinity']}</td></tr>"
191 
+                bd += f"<tr><td>{r0['name']}</td><td>{openh}</td><td>{r0['vicinity']}</td></tr>"
186 192
187 
-        rt = f'''
188 
-<br>
189 
-        <table><thead><tr><th>Name</th><th>Opening Hours</th><th>Vicinity</th></tr></thead>
190 
-        <tbody>
191 
-            {bd}
192 
-        </tbody>
193 
-        </table>
194 
-        '''
195 
-        return rt
193 
+            rt = f'''
194 
+    <br>
195 
+            <table><thead><tr><th>Name</th><th>Opening Hours</th><th>Vicinity</th></tr></thead>
196 
+            <tbody>
197 
+                {bd}
198 
+            </tbody>
199 
+            </table>
200 
+            '''
201 
+            return rt
202 
+        except:
203 
+            return "-"
196 204
197 205
198 206 
 
@@ -250,6 +258,9 @@ class Hospital(models.Model):
250 258 
     address = map_fields.AddressField(max_length=200)
251 259 
     geolocation = map_fields.GeoLocationField(max_length=100)
252 260
261 
+    tel = models.CharField(max_length=100, null=True, blank=True)
262 
+    line_id = models.CharField(max_length=100, null=True, blank=True)
263 
+
253 264 
     created_at = models.DateTimeField(auto_now_add=True, null=True)
254 265 
     updated_at = models.DateTimeField(auto_now=True)
255 266

BIN
app/front/__pycache__/urls.cpython-39.pyc
Voir le fichier


BIN
app/front/__pycache__/views.cpython-39.pyc
Voir le fichier


BIN
app/front/migrations/__pycache__/__init__.cpython-39.pyc
Voir le fichier


+ 8 - 0
app/front/templates/front/404.html
Voir le fichier 

@@ -0,0 +1,8 @@
1 
+
2 
+{% extends "base.html" %}
3 
+
4 
+{% block content %}
5 
+<div class="alert alert-success" role="alert">
6 
+<h1>ไม่มี page นี้</h1>
7 
+</div>
8 
+{% endblock %}

+ 7 - 3
app/front/templates/front/index.html
Voir le fichier 

@@ -11,8 +11,10 @@
11 11 
         <br>
12 12 
         <input type='text' name='lastName' class='form-control' placeholder='นามสกุล' required/>
13 13 
         <br>
14 
-        <input type='text' name='idCard' class='form-control' placeholder='หมายเลขบัตรประชาชน' required />
15 
-        <br>
14 
+        <!--
15 
+        <input type='text' name='idCard' class='form-control' placeholder='หมายเลขบัตรประชาชน' required />
16 
+        <br> -->
17 
+        <label>วันเกิด</label>
16 18 
         <input type='date' name='bd' class='form-control' placeholder='วันเกิด' required />
17 19 
         <br>
18 20 
         <textarea name='address' class='form-control' placeholder='ที่อยู่' required></textarea>  
@@ -21,8 +23,10 @@
21 23 
         <br>
22 24 
         <input type='tel' name='tel' class='form-control' placeholder='Tel.' required/>
23 25 
         <br>
26 
+        <input type='text' name='line_id' class='form-control' placeholder='Line ID'/>
27 
+        <br>
24 28 
         <label>อัพโหลดภาพ</label>
25 
-        <input type="file" name='photo' accept="image/*;capture=camera" class='form-control' required> </br>
29 
+        <input type="file" name='photo' accept="image/*;capture=camera" class='form-control'> </br>
26 30 
         <span class="glyphicon glyphicon-map-marker"></span>
27 31 
         <a class='btn btn-primary form-control' id="currentLocationBtn">
28 32 
         <i class="bi bi-geo-alt-fill"></i>

+ 33 - 0
app/front/templates/front/tracking.html
Voir le fichier 

@@ -0,0 +1,33 @@
1 
+
2 
+{% extends "base.html" %}
3 
+
4 
+{% block content %}
5 
+<div class="alert alert-success" role="alert">
6 
+<h1>Tracking</h1>
7 
+        <input type='text' class='form-control' name='geo' id='geoText' readonly/><br>
8 
+        <br>Last Update
9 
+        <span id='lastUpdate'></span>
10 
+</div>
11 
+{% endblock %}
12 
+{% block foot_script %}
13 
+<script>
14 
+    $(function() {
15 
+
16 
+        setInterval(function(){
17 
+            console.log("Hello");
18 
+            if ("geolocation" in navigator){ //check geolocation available
19 
+                //try to get user current location using getCurrentPosition() method
20 
+                console.log("current location");
21 
+                navigator.geolocation.getCurrentPosition(function(position){
22 
+                    console.log("xxxx");
23 
+                    $("#geoText").val(position.coords.latitude+","+position.coords.longitude );
24 
+                    $("#lastUpdate").html(new Date());
25 
+
26 
+                });
27 
+            }else{
28 
+                console.log("Browser doesn't support geolocation!");
29 
+            }
30 
+        }, 5000);
31 
+    });
32 
+</script>
33 
+{% endblock %}

+ 1 - 0
app/front/urls.py
Voir le fichier 

@@ -5,5 +5,6 @@ from . import views
5 5
6 6 
 urlpatterns = [
7 7 
     path('', views.index, name='index'),
8 
+    path('tracking', views.tracking, name='tracking'),
8 9 
     path('success', views.success, name='success'),
9 10 
 ]

+ 11 - 1
app/front/views.py
Voir le fichier 

@@ -10,11 +10,13 @@ def index(request):
10 10 
         p = Patient()
11 11 
         p.first_name = request.POST.get('firstName')
12 12 
         p.last_name = request.POST.get('lastName')
13 
-        p.idcard = request.POST.get('idCard')
13 
+        #p.idcard = request.POST.get('idCard')
14 14 
         p.address = request.POST.get('address')
15 15 
         p.geolocation = request.POST.get('geo')
16 16 
         p.birth_date = request.POST.get('bd')
17 17 
         p.comment = request.POST.get('comment')
18 
+        p.tel = request.POST.get('tel')
19 
+        p.line_id = request.POST.get('line_id')
18 20 
         p.photo = request.FILES.get('photo')
19 21 
         p.patient_status = "request"
20 22 
         p.save()
 
@@ -23,3 +25,11 @@ def index(request):
23 25
24 26 
 def success(request):
25 27 
     return render(request, 'front/success.html')
28 
+
29 
+def tracking(request):
30 
+    return render(request, 'front/tracking.html')
31 
+
32 
+def my404(request,exception):
33 
+    return render(request, 'front/404.html')
34 
+    #return redirect("index")
35 
+

BIN
app/shaqfindbed/__pycache__/settings.cpython-39.pyc
Voir le fichier


BIN
app/shaqfindbed/__pycache__/urls.cpython-39.pyc
Voir le fichier


+ 5 - 1
app/shaqfindbed/settings.py
Voir le fichier 

@@ -27,7 +27,11 @@ SECRET_KEY = 'django-insecure-!=!d6rsewcddw=hr-j46#))^nd-32(kkjmnpxxioi(v&c9!*xn
27 27 
 # SECURITY WARNING: don't run with debug turned on in production!
28 28 
 DEBUG = True
29 29
30 
-ALLOWED_HOSTS = []
30 
+ALLOWED_HOSTS = [
31 
+    "167.71.218.44",
32 
+    "localhost",
33 
+    '.findbed.xyz'
34 
+]
31 35
32 36
33 37 
 # Application definition

+ 6 - 1
app/shaqfindbed/urls.py
Voir le fichier 

@@ -18,13 +18,18 @@ from django.urls import path, include
18 18 
 from django.conf import settings
19 19 
 from django.conf.urls import url
20 20 
 from django.conf.urls.static import static
21 
+from django.views.static import serve
22 
+
21 23
22 24 
 urlpatterns = [
25 
+    path('', include('front.urls')),
23 26 
     path('backend/', include('backend.urls')),
24 
-    path('front/', include('front.urls')),
25 27 
     path('admin/', admin.site.urls),
26 28 
     url(r'^chaining/', include('smart_selects.urls')),
29 
+    url(r'^media/(?P<path>.*)$', serve,{'document_root': settings.MEDIA_ROOT}),
27 30 
 ] + static(settings.STATIC_URL, document_root=settings.STATIC_ROOT)
28 31
32 
+
29 33 
 if settings.DEBUG:
30 34 
     urlpatterns += static(settings.MEDIA_URL, document_root=settings.MEDIA_ROOT)
35 
+handler404 = 'front.views.my404'

+ 162 - 0
app/staticfile/autocomplete_light/autocomplete.init.js
Voir le fichier 

@@ -0,0 +1,162 @@
1 
+/*
2 
+This script garantees that this will be called once in django admin.
3 
+However, its the callback's responsability to clean up if the
4 
+element was cloned with data - which should be the case.
5 
+*/
6 
+
7 
+;(function ($) {
8 
+    $.fn.getFormPrefix = function() {
9 
+        /* Get the form prefix for a field.
10 
+         *
11 
+         * For example:
12 
+         *
13 
+         *     $(':input[name$=owner]').getFormsetPrefix()
14 
+         *
15 
+         * Would return an empty string for an input with name 'owner' but would return
16 
+         * 'inline_model-0-' for an input named 'inline_model-0-owner'.
17 
+         */
18 
+        var parts = $(this).attr('name').split('-');
19 
+        var prefix = '';
20 
+
21 
+        for (var i in parts) {
22 
+            var testPrefix = parts.slice(0, -i).join('-');
23 
+            if (! testPrefix.length) continue;
24 
+            testPrefix += '-';
25 
+
26 
+            var result = $(':input[name^=' + testPrefix + ']')
27 
+
28 
+            if (result.length) {
29 
+                return testPrefix;
30 
+            }
31 
+        }
32 
+
33 
+        return '';
34 
+    }
35 
+
36 
+    $.fn.getFormPrefixes = function() {
37 
+        /*
38 
+         * Get the form prefixes for a field, from the most specific to the least.
39 
+         *
40 
+         * For example:
41 
+         *
42 
+         *      $(':input[name$=owner]').getFormPrefixes()
43 
+         *
44 
+         * Would return:
45 
+         * - [''] for an input named 'owner'.
46 
+         * - ['inline_model-0-', ''] for an input named 'inline_model-0-owner' (i.e. nested with a nested inline).
47 
+         * - ['sections-0-items-0-', 'sections-0-', ''] for an input named 'sections-0-items-0-product'
48 
+         *   (i.e. nested multiple time with django-nested-admin).
49 
+         */
50 
+        var parts = $(this).attr('name').split('-').slice(0, -1);
51 
+        var prefixes = [];
52 
+
53 
+        for (i = 0; i < parts.length; i += 2) {
54 
+            var testPrefix = parts.slice(0, -i || parts.length).join('-');
55 
+            if (!testPrefix.length)
56 
+                continue;
57 
+
58 
+            testPrefix += '-';
59 
+
60 
+            var result = $(':input[name^=' + testPrefix + ']')
61 
+
62 
+            if (result.length)
63 
+                prefixes.push(testPrefix);
64 
+        }
65 
+
66 
+        prefixes.push('');
67 
+
68 
+        return prefixes;
69 
+    }
70 
+
71 
+    var initialized = [];
72 
+
73 
+    function initialize(element) {
74 
+        if (typeof element === 'undefined' || typeof element === 'number') {
75 
+            element = this;
76 
+        }
77 
+
78 
+        if (window.__dal__initListenerIsSet !== true || initialized.indexOf(element) >= 0) {
79 
+            return;
80 
+        }
81 
+
82 
+        $(element).trigger('autocompleteLightInitialize');
83 
+        initialized.push(element);
84 
+    }
85 
+
86 
+    if (!window.__dal__initialize) {
87 
+        window.__dal__initialize = initialize;
88 
+
89 
+        $(document).ready(function () {
90 
+            $('[data-autocomplete-light-function=select2]:not([id*="__prefix__"])').each(initialize);
91 
+        });
92 
+
93 
+        $(document).bind('DOMNodeInserted', function (e) {
94 
+            $(e.target).find('[data-autocomplete-light-function=select2]').each(initialize);
95 
+        });
96 
+    }
97 
+
98 
+    // using jQuery
99 
+    function getCookie(name) {
100 
+        var cookieValue = null;
101 
+        if (document.cookie && document.cookie != '') {
102 
+            var cookies = document.cookie.split(';');
103 
+            for (var i = 0; i < cookies.length; i++) {
104 
+                var cookie = $.trim(cookies[i]);
105 
+                // Does this cookie string begin with the name we want?
106 
+                if (cookie.substring(0, name.length + 1) == (name + '=')) {
107 
+                    cookieValue = decodeURIComponent(cookie.substring(name.length + 1));
108 
+                    break;
109 
+                }
110 
+            }
111 
+        }
112 
+        return cookieValue;
113 
+    }
114 
+
115 
+    document.csrftoken = getCookie('csrftoken');
116 
+    if (document.csrftoken === null) {
117 
+        // Try to get CSRF token from DOM when cookie is missing
118 
+        var $csrf = $('form :input[name="csrfmiddlewaretoken"]');
119 
+        if ($csrf.length > 0) {
120 
+            document.csrftoken = $csrf[0].value;
121 
+        }
122 
+    }
123 
+})(yl.jQuery);
124 
+
125 
+// Does the same thing as django's admin/js/autocomplete.js, but uses yl.jQuery.
126 
+(function($) {
127 
+    'use strict';
128 
+    var init = function($element, options) {
129 
+        var settings = $.extend({
130 
+            ajax: {
131 
+                data: function(params) {
132 
+                    return {
133 
+                        term: params.term,
134 
+                        page: params.page
135 
+                    };
136 
+                }
137 
+            }
138 
+        }, options);
139 
+        $element.select2(settings);
140 
+    };
141 
+
142 
+    $.fn.djangoAdminSelect2 = function(options) {
143 
+        var settings = $.extend({}, options);
144 
+        $.each(this, function(i, element) {
145 
+            var $element = $(element);
146 
+            init($element, settings);
147 
+        });
148 
+        return this;
149 
+    };
150 
+
151 
+    $(function() {
152 
+        // Initialize all autocomplete widgets except the one in the template
153 
+        // form used when a new formset is added.
154 
+        $('.admin-autocomplete').not('[name*=__prefix__]').djangoAdminSelect2();
155 
+    });
156 
+
157 
+    $(document).on('formset:added', (function() {
158 
+        return function(event, $newFormset) {
159 
+            return $newFormset.find('.admin-autocomplete').djangoAdminSelect2();
160 
+        };
161 
+    })(this));
162 
+}(yl.jQuery));

+ 191 - 0
app/staticfile/autocomplete_light/forward.js
Voir le fichier 

@@ -0,0 +1,191 @@
1 
+;(function($, yl) {
2 
+    yl.forwardHandlerRegistry = yl.forwardHandlerRegistry || {};
3 
+
4 
+    yl.registerForwardHandler = function(name, handler) {
5 
+        yl.forwardHandlerRegistry[name] = handler;
6 
+    };
7 
+
8 
+    yl.getForwardHandler = function(name) {
9 
+        return yl.forwardHandlerRegistry[name];
10 
+    };
11 
+
12 
+    function getForwardStrategy(element) {
13 
+        var checkForCheckboxes = function() {
14 
+            var all = true;
15 
+            $.each(element, function(ix, e) {
16 
+                if ($(e).attr("type") !== "checkbox") {
17 
+                    all = false;
18 
+                }
19 
+            });
20 
+            return all;
21 
+        };
22 
+
23 
+        if (element.length === 1 &&
24 
+                element.attr("type") === "checkbox" &&
25 
+                element.attr("value") === undefined) {
26 
+            // Single checkbox without 'value' attribute
27 
+            // Boolean field
28 
+            return "exists";
29 
+        } else if (element.length === 1 &&
30 
+                element.attr("multiple") !== undefined) {
31 
+            // Multiple by HTML semantics. E. g. multiple select
32 
+            // Multiple choice field
33 
+            return "multiple";
34 
+        } else if (checkForCheckboxes()) {
35 
+            // Multiple checkboxes or one checkbox with 'value' attribute.
36 
+            // Multiple choice field represented by checkboxes
37 
+            return "multiple";
38 
+        } else {
39 
+            // Other cases
40 
+            return "single";
41 
+        }
42 
+    }
43 
+
44 
+    /**
45 
+     * Get fields with name `name` relative to `element` with considering form
46 
+     * prefixes.
47 
+     * @param element the element
48 
+     * @param name name of the field
49 
+     * @returns jQuery object with found fields or empty jQuery object if no
50 
+     * field was found
51 
+     */
52 
+    yl.getFieldRelativeTo = function(element, name) {
53 
+        var prefixes = $(element).getFormPrefixes();
54 
+
55 
+        for (var i = 0; i < prefixes.length; i++) {
56 
+            var fieldSelector = "[name=" + prefixes[i] + name + "]";
57 
+            var field = $(fieldSelector);
58 
+
59 
+            if (field.length) {
60 
+                return field;
61 
+            }
62 
+        }
63 
+
64 
+        return $();
65 
+    };
66 
+
67 
+    /**
68 
+     * Get field value which is put to forwarded dictionary
69 
+     * @param field the field
70 
+     * @returns forwarded value
71 
+     */
72 
+    yl.getValueFromField = function(field) {
73 
+        var strategy = getForwardStrategy(field);
74 
+        var serializedField = $(field).serializeArray();
75 
+
76 
+        if ((serializedField == false) && ($(field).prop('disabled'))) {
77 
+            $(field).prop('disabled', false);
78 
+            serializedField = $(field).serializeArray();
79 
+            $(field).prop('disabled', true);
80 
+        }
81 
+
82 
+        var getSerializedFieldElementAt = function (index) {
83 
+            // Return serializedField[index]
84 
+            // or null if something went wrong
85 
+            if (serializedField.length > index) {
86 
+                return serializedField[index];
87 
+            } else {
88 
+                return null;
89 
+            }
90 
+        };
91 
+
92 
+        var getValueOf = function (elem) {
93 
+            // Return elem.value
94 
+            // or null if something went wrong
95 
+            if (elem.hasOwnProperty("value") &&
96 
+                elem.value !== undefined
97 
+            ) {
98 
+                return elem.value;
99 
+            } else {
100 
+                return null;
101 
+            }
102 
+        };
103 
+
104 
+        var getSerializedFieldValueAt = function (index) {
105 
+            // Return serializedField[index].value
106 
+            // or null if something went wrong
107 
+            var elem = getSerializedFieldElementAt(index);
108 
+            if (elem !== null) {
109 
+                return getValueOf(elem);
110 
+            } else {
111 
+                return null;
112 
+            }
113 
+        };
114 
+
115 
+        if (strategy === "multiple") {
116 
+            return serializedField.map(
117 
+                function (item) {
118 
+                    return getValueOf(item);
119 
+                }
120 
+            );
121 
+        } else if (strategy === "exists") {
122 
+            return serializedField.length > 0;
123 
+        } else {
124 
+            return getSerializedFieldValueAt(0);
125 
+        }
126 
+    };
127 
+
128 
+    yl.getForwards = function(element) {
129 
+        var forwardElem,
130 
+            forwardList,
131 
+            forwardedData,
132 
+            divSelector,
133 
+            form;
134 
+        divSelector = "div.dal-forward-conf#dal-forward-conf-for-" +
135 
+                element.attr("id") + ", " +
136 
+                "div.dal-forward-conf#dal-forward-conf-for_" +
137 
+                element.attr("id");
138 
+        form = element.length > 0 ? $(element[0].form) : $();
139 
+
140 
+        forwardElem =
141 
+            form.find(divSelector).find('script');
142 
+        if (forwardElem.length === 0) {
143 
+            return;
144 
+        }
145 
+        try {
146 
+            forwardList = JSON.parse(forwardElem.text());
147 
+        } catch (e) {
148 
+            return;
149 
+        }
150 
+
151 
+        if (!Array.isArray(forwardList)) {
152 
+            return;
153 
+        }
154 
+
155 
+        forwardedData = {};
156 
+
157 
+        $.each(forwardList, function(ix, field) {
158 
+            var srcName, dstName;
159 
+            if (field.type === "const") {
160 
+                forwardedData[field.dst] = field.val;
161 
+            } else if (field.type === "self") {
162 
+                if (field.hasOwnProperty("dst")) {
163 
+                    dstName = field.dst;
164 
+                } else {
165 
+                    dstName = "self";
166 
+                }
167 
+                forwardedData[dstName] = yl.getValueFromField(element);
168 
+            } else if (field.type === "field") {
169 
+                srcName = field.src;
170 
+                if (field.hasOwnProperty("dst")) {
171 
+                    dstName = field.dst;
172 
+                } else {
173 
+                    dstName = srcName;
174 
+                }
175 
+                var forwardedField = yl.getFieldRelativeTo(element, srcName);
176 
+
177 
+                if (!forwardedField.length) {
178 
+                    return;
179 
+                }
180 
+
181 
+                forwardedData[dstName] = yl.getValueFromField(forwardedField);
182 
+            } else if (field.type === "javascript") {
183 
+                var handler = yl.getForwardHandler(field.handler);
184 
+                forwardedData[field.dst || field.handler] = handler(element);
185 
+            }
186 
+
187 
+        });
188 
+        return JSON.stringify(forwardedData);
189 
+    };
190 
+
191 
+})(yl.jQuery, yl);

+ 36 - 0
app/staticfile/autocomplete_light/jquery.init.js
Voir le fichier 

@@ -0,0 +1,36 @@
1 
+var yl = yl || {};
2 
+if (typeof django !== 'undefined' && typeof django.jQuery !== 'undefined') {
3 
+    // If django.jQuery is already defined, use it.
4 
+    yl.jQuery = django.jQuery;
5 
+}
6 
+else {
7 
+    // We include jquery itself in our widget's media, because we need it.
8 
+    // Normally, we expect our widget's reference to admin/js/vendor/jquery/jquery.js
9 
+    // to be skipped, because django's own code has already included it.
10 
+    // However, if django.jQuery is NOT defined, we know that jquery was not
11 
+    // included before we did it ourselves. This can happen if we're not being
12 
+    // rendered in a django admin form.
13 
+    // However, someone ELSE'S jQuery may have been included before ours, in
14 
+    // which case we must ensure that our jquery doesn't override theirs, since
15 
+    // it might be a newer version that other code on the page relies on.
16 
+    // Thus, we must run jQuery.noConflict(true) here to move our jQuery out of
17 
+    // the way.
18 
+    yl.jQuery = jQuery.noConflict(true);
19 
+}
20 
+
21 
+// In addition to all of this, we must ensure that the global jQuery and $ are
22 
+// defined, because Select2 requires that. jQuery will only be undefined at
23 
+// this point if only we or django included it.
24 
+if (typeof jQuery === 'undefined') {
25 
+    jQuery = yl.jQuery;
26 
+    $ = yl.jQuery;
27 
+}
28 
+else {
29 
+    // jQuery IS still defined, which means someone else also included jQuery.
30 
+    // In this situation, we need to store the old jQuery in a
31 
+    // temp variable, set the global jQuery to our yl.jQuery, then let select2
32 
+    // set itself up. We restore the global jQuery to its original value in
33 
+    // jquery.post-setup.js.
34 
+    dal_jquery_backup = jQuery.noConflict(true);
35 
+    jQuery = yl.jQuery;
36 
+}

+ 7 - 0
app/staticfile/autocomplete_light/jquery.post-setup.js
Voir le fichier 

@@ -0,0 +1,7 @@
1 
+if (typeof dal_jquery_backup !== 'undefined') {
2 
+    // We made a backup of the original global jQuery before forcing it to our
3 
+    // yl.jQuery value. Now that select2 has been set up, we need to restore
4 
+    // our backup to its rightful place.
5 
+    jQuery = dal_jquery_backup;
6 
+    $ = dal_jquery_backup;
7 
+}

+ 14 - 0
app/staticfile/autocomplete_light/select2.css
Voir le fichier 

@@ -0,0 +1,14 @@
1 
+.select2-container {
2 
+    min-width: 20em;
3 
+}
4 
+
5 
+ul li.select2-selection__choice,
6 
+ul li.select2-search {
7 
+    /* Cancel out django's style */
8 
+    list-style-type: none;
9 
+}
10 
+
11 
+.errors .select2-selection {
12 
+    /* Highlight select box with error */
13 
+    border-color: #ba2121;
14 
+}

+ 122 - 0
app/staticfile/autocomplete_light/select2.js
Voir le fichier 

@@ -0,0 +1,122 @@
1 
+;(function ($) {
2 
+    if (window.__dal__initListenerIsSet)
3 
+        return;
4 
+
5 
+    $(document).on('autocompleteLightInitialize', '[data-autocomplete-light-function=select2]', function() {
6 
+        var element = $(this);
7 
+
8 
+        // Templating helper
9 
+        function template(text, is_html) {
10 
+            if (is_html) {
11 
+                var $result = $('<span>');
12 
+                $result.html(text);
13 
+                return $result;
14 
+            } else {
15 
+                return text;
16 
+            }
17 
+        }
18 
+
19 
+        function result_template(item) {
20 
+            var text = template(item.text,
21 
+                element.attr('data-html') !== undefined || element.attr('data-result-html') !== undefined
22 
+            );
23 
+
24 
+            if (item.create_id) {
25 
+                return $('<span></span>').text(text).addClass('dal-create')
26 
+            } else {
27 
+                return text
28 
+            }
29 
+        }
30 
+
31 
+        function selected_template(item) {
32 
+            if (item.selected_text !== undefined) {
33 
+                return template(item.selected_text,
34 
+                    element.attr('data-html') !== undefined || element.attr('data-selected-html') !== undefined
35 
+                );
36 
+            } else {
37 
+                return result_template(item);
38 
+            }
39 
+            return
40 
+        }
41 
+
42 
+        var ajax = null;
43 
+        if ($(this).attr('data-autocomplete-light-url')) {
44 
+            ajax = {
45 
+                url: $(this).attr('data-autocomplete-light-url'),
46 
+                dataType: 'json',
47 
+                delay: 250,
48 
+
49 
+                data: function (params) {
50 
+                    var data = {
51 
+                        q: params.term, // search term
52 
+                        page: params.page,
53 
+                        create: element.attr('data-autocomplete-light-create') && !element.attr('data-tags'),
54 
+                        forward: yl.getForwards(element)
55 
+                    };
56 
+
57 
+                    return data;
58 
+                },
59 
+                processResults: function (data, page) {
60 
+                    if (element.attr('data-tags')) {
61 
+                        $.each(data.results, function(index, value) {
62 
+                            value.id = value.text;
63 
+                        });
64 
+                    }
65 
+
66 
+                    return data;
67 
+                },
68 
+                cache: true
69 
+            };
70 
+        }
71 
+
72 
+        $(this).select2({
73 
+            tokenSeparators: element.attr('data-tags') ? [','] : null,
74 
+            debug: true,
75 
+            containerCssClass: ':all:',
76 
+            placeholder: element.attr('data-placeholder') || '',
77 
+            language: element.attr('data-autocomplete-light-language'),
78 
+            minimumInputLength: element.attr('data-minimum-input-length') || 0,
79 
+            allowClear: ! $(this).is('[required]'),
80 
+            templateResult: result_template,
81 
+            templateSelection: selected_template,
82 
+            ajax: ajax,
83 
+            tags: Boolean(element.attr('data-tags')),
84 
+        });
85 
+
86 
+        $(this).on('select2:selecting', function (e) {
87 
+            var data = e.params.args.data;
88 
+
89 
+            if (data.create_id !== true)
90 
+                return;
91 
+
92 
+            e.preventDefault();
93 
+
94 
+            var select = $(this);
95 
+
96 
+            $.ajax({
97 
+                url: $(this).attr('data-autocomplete-light-url'),
98 
+                type: 'POST',
99 
+                dataType: 'json',
100 
+                data: {
101 
+                    text: data.id,
102 
+                    forward: yl.getForwards($(this))
103 
+                },
104 
+                beforeSend: function(xhr, settings) {
105 
+                    xhr.setRequestHeader("X-CSRFToken", document.csrftoken);
106 
+                },
107 
+                success: function(data, textStatus, jqXHR ) {
108 
+                    select.append(
109 
+                        $('<option>', {value: data.id, text: data.text, selected: true})
110 
+                    );
111 
+                    select.trigger('change');
112 
+                    select.select2('close');
113 
+                }
114 
+            });
115 
+        });
116 
+
117 
+    });
118 
+    window.__dal__initListenerIsSet = true;
119 
+    $('[data-autocomplete-light-function=select2]:not([id*="__prefix__"])').each(function() {
120 
+        window.__dal__initialize(this);
121 
+    });
122 
+})(yl.jQuery);

BIN
app/staticfile/img/heartbeat.png
Voir le fichier


+ 22 - 0
app/staticfile/import_export/action_formats.js
Voir le fichier 

@@ -0,0 +1,22 @@
1 
+(function($) {
2 
+  $(document).ready(function() {
3 
+    var $actionsSelect, $formatsElement;
4 
+    if ($('body').hasClass('grp-change-list')) {
5 
+        // using grappelli
6 
+        $actionsSelect = $('#grp-changelist-form select[name="action"]');
7 
+        $formatsElement = $('#grp-changelist-form select[name="file_format"]');
8 
+    } else {
9 
+        // using default admin
10 
+        $actionsSelect = $('#changelist-form select[name="action"]');
11 
+        $formatsElement = $('#changelist-form select[name="file_format"]').parent();
12 
+    }
13 
+    $actionsSelect.change(function() {
14 
+      if ($(this).val() === 'export_admin_action') {
15 
+        $formatsElement.show();
16 
+      } else {
17 
+        $formatsElement.hide();
18 
+      }
19 
+    });
20 
+    $actionsSelect.change();
21 
+  });
22 
+})(django.jQuery);

+ 81 - 0
app/staticfile/import_export/import.css
Voir le fichier 

@@ -0,0 +1,81 @@
1 
+.import-preview .errors {
2 
+  position: relative;
3 
+}
4 
+
5 
+.validation-error-count {
6 
+  display: inline-block;
7 
+  background-color: #e40000;
8 
+  border-radius: 6px;
9 
+  color: white;
10 
+  font-size: 0.9em;
11 
+  position: relative;
12 
+  font-weight: bold;
13 
+  margin-top: -2px;
14 
+  padding: 0.2em 0.4em;
15 
+}
16 
+
17 
+.validation-error-container {
18 
+  position: absolute;
19 
+  opacity: 0;
20 
+  pointer-events: none;
21 
+  background-color: #ffc1c1;
22 
+  padding: 14px 15px 10px;
23 
+  top: 25px;
24 
+  margin: 0 0 20px 0;
25 
+  width: 200px;
26 
+  z-index: 2;
27 
+}
28 
+
29 
+table.import-preview tr.skip {
30 
+  background-color: #d2d2d2;
31 
+}
32 
+
33 
+table.import-preview tr.new {
34 
+  background-color: #bdd8b2;
35 
+}
36 
+
37 
+table.import-preview tr.delete {
38 
+  background-color: #f9bebf;
39 
+}
40 
+
41 
+table.import-preview tr.update {
42 
+  background-color: #fdfdcf;
43 
+}
44 
+
45 
+.import-preview td:hover .validation-error-count {
46 
+  z-index: 3;
47 
+}
48 
+.import-preview td:hover .validation-error-container {
49 
+  opacity: 1;
50 
+  pointer-events: auto;
51 
+}
52 
+
53 
+.validation-error-list {
54 
+  margin: 0;
55 
+  padding: 0;
56 
+}
57 
+
58 
+.validation-error-list li {
59 
+  list-style: none;
60 
+  margin: 0;
61 
+}
62 
+
63 
+.validation-error-list > li > ul {
64 
+  margin: 8px 0;
65 
+  padding: 0;
66 
+}
67 
+
68 
+.validation-error-list > li > ul > li {
69 
+  padding: 0;
70 
+  margin: 0 0 10px;
71 
+  line-height: 1.28em;
72 
+}
73 
+
74 
+.validation-error-field-label {
75 
+  display: block;
76 
+  border-bottom: 1px solid #e40000;
77 
+  color: #e40000;
78 
+  text-transform: uppercase;
79 
+  font-weight: bold;
80 
+  font-size: 0.85em;
81 
+}

+ 15 - 0
app/staticfile/js/main.js
Voir le fichier 

@@ -0,0 +1,15 @@
1 
+$(function(){
2 
+    $("#currentLocationBtn").click(function(){
3 
+        if ("geolocation" in navigator){ //check geolocation available
4 
+            //try to get user current location using getCurrentPosition() method
5 
+            console.log("current location");
6 
+            navigator.geolocation.getCurrentPosition(function(position){
7 
+                console.log("xxxx");
8 
+                $("#geoText").val(position.coords.latitude+","+position.coords.longitude );
9 
+
10 
+            });
11 
+        }else{
12 
+            console.log("Browser doesn't support geolocation!");
13 
+        }
14 
+    });
15 
+});

+ 262 - 0
app/staticfile/vendor/select2/Gruntfile.js
Voir le fichier 

@@ -0,0 +1,262 @@
1 
+const sass = require('node-sass');
2 
+
3 
+module.exports = function (grunt) {
4 
+  // Full list of files that must be included by RequireJS
5 
+  includes = [
6 
+    'jquery.select2',
7 
+    'almond',
8 
+
9 
+    'jquery-mousewheel' // shimmed for non-full builds
10 
+  ];
11 
+
12 
+  fullIncludes = [
13 
+    'jquery',
14 
+
15 
+    'select2/compat/containerCss',
16 
+    'select2/compat/dropdownCss',
17 
+
18 
+    'select2/compat/initSelection',
19 
+    'select2/compat/inputData',
20 
+    'select2/compat/matcher',
21 
+    'select2/compat/query',
22 
+
23 
+    'select2/dropdown/attachContainer',
24 
+    'select2/dropdown/stopPropagation',
25 
+
26 
+    'select2/selection/stopPropagation'
27 
+  ].concat(includes);
28 
+
29 
+  var i18nModules = [];
30 
+  var i18nPaths = {};
31 
+
32 
+  var i18nFiles = grunt.file.expand({
33 
+    cwd: 'src/js'
34 
+  }, 'select2/i18n/*.js');
35 
+
36 
+  var testFiles = grunt.file.expand('tests/**/*.html');
37 
+  var testUrls = testFiles.map(function (filePath) {
38 
+    return 'http://localhost:9999/' + filePath;
39 
+  });
40 
+
41 
+  var testBuildNumber = "unknown";
42 
+
43 
+  if (process.env.TRAVIS_JOB_ID) {
44 
+    testBuildNumber = "travis-" + process.env.TRAVIS_JOB_ID;
45 
+  } else {
46 
+    var currentTime = new Date();
47 
+
48 
+    testBuildNumber = "manual-" + currentTime.getTime();
49 
+  }
50 
+
51 
+  for (var i = 0; i < i18nFiles.length; i++) {
52 
+    var file = i18nFiles[i];
53 
+    var name = file.split('.')[0];
54 
+
55 
+    i18nModules.push({
56 
+      name: name
57 
+    });
58 
+
59 
+    i18nPaths[name] = '../../' + name;
60 
+  }
61 
+
62 
+  var minifiedBanner = '/*! Select2 <%= package.version %> | https://github.com/select2/select2/blob/master/LICENSE.md */';
63 
+
64 
+  grunt.initConfig({
65 
+    package: grunt.file.readJSON('package.json'),
66 
+
67 
+    concat: {
68 
+      'dist': {
69 
+        options: {
70 
+          banner: grunt.file.read('src/js/wrapper.start.js'),
71 
+        },
72 
+        src: [
73 
+          'dist/js/select2.js',
74 
+          'src/js/wrapper.end.js'
75 
+        ],
76 
+        dest: 'dist/js/select2.js'
77 
+      },
78 
+      'dist.full': {
79 
+        options: {
80 
+          banner: grunt.file.read('src/js/wrapper.start.js'),
81 
+        },
82 
+        src: [
83 
+          'dist/js/select2.full.js',
84 
+          'src/js/wrapper.end.js'
85 
+        ],
86 
+        dest: 'dist/js/select2.full.js'
87 
+      }
88 
+    },
89 
+
90 
+    connect: {
91 
+      tests: {
92 
+        options: {
93 
+          base: '.',
94 
+          hostname: '127.0.0.1',
95 
+          port: 9999
96 
+        }
97 
+      }
98 
+    },
99 
+
100 
+    uglify: {
101 
+      'dist': {
102 
+        src: 'dist/js/select2.js',
103 
+        dest: 'dist/js/select2.min.js',
104 
+        options: {
105 
+          banner: minifiedBanner
106 
+        }
107 
+      },
108 
+      'dist.full': {
109 
+        src: 'dist/js/select2.full.js',
110 
+        dest: 'dist/js/select2.full.min.js',
111 
+        options: {
112 
+          banner: minifiedBanner
113 
+        }
114 
+      }
115 
+    },
116 
+
117 
+    qunit: {
118 
+      all: {
119 
+        options: {
120 
+          urls: testUrls
121 
+        }
122 
+      }
123 
+    },
124 
+
125 
+    jshint: {
126 
+      options: {
127 
+        jshintrc: true,
128 
+        reporterOutput: ''
129 
+      },
130 
+      code: {
131 
+        src: ['src/js/**/*.js']
132 
+      },
133 
+      tests: {
134 
+        src: ['tests/**/*.js']
135 
+      }
136 
+    },
137 
+
138 
+    sass: {
139 
+      dist: {
140 
+        options: {
141 
+          implementation: sass,
142 
+          outputStyle: 'compressed'
143 
+        },
144 
+        files: {
145 
+          'dist/css/select2.min.css': [
146 
+            'src/scss/core.scss',
147 
+            'src/scss/theme/default/layout.css'
148 
+          ]
149 
+        }
150 
+      },
151 
+      dev: {
152 
+        options: {
153 
+          implementation: sass,
154 
+          outputStyle: 'nested'
155 
+        },
156 
+        files: {
157 
+          'dist/css/select2.css': [
158 
+            'src/scss/core.scss',
159 
+            'src/scss/theme/default/layout.css'
160 
+          ]
161 
+        }
162 
+      }
163 
+    },
164 
+
165 
+    requirejs: {
166 
+      'dist': {
167 
+        options: {
168 
+          baseUrl: 'src/js',
169 
+          optimize: 'none',
170 
+          name: 'select2/core',
171 
+          out: 'dist/js/select2.js',
172 
+          include: includes,
173 
+          namespace: 'S2',
174 
+          paths: {
175 
+            'almond': require.resolve('almond').slice(0, -3),
176 
+            'jquery': 'jquery.shim',
177 
+            'jquery-mousewheel': 'jquery.mousewheel.shim'
178 
+          },
179 
+          wrap: {
180 
+            startFile: 'src/js/banner.start.js',
181 
+            endFile: 'src/js/banner.end.js'
182 
+          }
183 
+        }
184 
+      },
185 
+      'dist.full': {
186 
+        options: {
187 
+          baseUrl: 'src/js',
188 
+          optimize: 'none',
189 
+          name: 'select2/core',
190 
+          out: 'dist/js/select2.full.js',
191 
+          include: fullIncludes,
192 
+          namespace: 'S2',
193 
+          paths: {
194 
+            'almond': require.resolve('almond').slice(0, -3),
195 
+            'jquery': 'jquery.shim',
196 
+            'jquery-mousewheel': require.resolve('jquery-mousewheel').slice(0, -3)
197 
+          },
198 
+          wrap: {
199 
+            startFile: 'src/js/banner.start.js',
200 
+            endFile: 'src/js/banner.end.js'
201 
+          }
202 
+        }
203 
+      },
204 
+      'i18n': {
205 
+        options: {
206 
+          baseUrl: 'src/js/select2/i18n',
207 
+          dir: 'dist/js/i18n',
208 
+          paths: i18nPaths,
209 
+          modules: i18nModules,
210 
+          namespace: 'S2',
211 
+          wrap: {
212 
+            start: minifiedBanner + grunt.file.read('src/js/banner.start.js'),
213 
+            end: grunt.file.read('src/js/banner.end.js')
214 
+          }
215 
+        }
216 
+      }
217 
+    },
218 
+
219 
+    watch: {
220 
+      js: {
221 
+        files: [
222 
+          'src/js/select2/**/*.js',
223 
+          'tests/**/*.js'
224 
+        ],
225 
+        tasks: [
226 
+          'compile',
227 
+          'test',
228 
+          'minify'
229 
+        ]
230 
+      },
231 
+      css: {
232 
+        files: [
233 
+          'src/scss/**/*.scss'
234 
+        ],
235 
+        tasks: [
236 
+          'compile',
237 
+          'minify'
238 
+        ]
239 
+      }
240 
+    }
241 
+  });
242 
+
243 
+  grunt.loadNpmTasks('grunt-contrib-concat');
244 
+  grunt.loadNpmTasks('grunt-contrib-connect');
245 
+  grunt.loadNpmTasks('grunt-contrib-jshint');
246 
+  grunt.loadNpmTasks('grunt-contrib-qunit');
247 
+  grunt.loadNpmTasks('grunt-contrib-requirejs');
248 
+  grunt.loadNpmTasks('grunt-contrib-uglify');
249 
+  grunt.loadNpmTasks('grunt-contrib-watch');
250 
+
251 
+  grunt.loadNpmTasks('grunt-sass');
252 
+
253 
+  grunt.registerTask('default', ['compile', 'test', 'minify']);
254 
+
255 
+  grunt.registerTask('compile', [
256 
+    'requirejs:dist', 'requirejs:dist.full', 'requirejs:i18n',
257 
+    'concat:dist', 'concat:dist.full',
258 
+    'sass:dev'
259 
+  ]);
260 
+  grunt.registerTask('minify', ['uglify', 'sass:dist']);
261 
+  grunt.registerTask('test', ['connect:tests', 'qunit', 'jshint']);
262 
+};

+ 13 - 0
app/staticfile/vendor/select2/bower.json
Voir le fichier 

@@ -0,0 +1,13 @@
1 
+{
2 
+    "name": "select2",
3 
+    "description": "Select2 is a jQuery based replacement for select boxes. It supports searching, remote data sets, and infinite scrolling of results.",
4 
+    "main": [
5 
+        "dist/js/select2.js",
6 
+        "src/scss/core.scss"
7 
+    ],
8 
+    "license": "MIT",
9 
+    "repository": {
10 
+        "type": "git",
11 
+        "url": "git@github.com:select2/select2.git"
12 
+    }
13 
+}

+ 19 - 0
app/staticfile/vendor/select2/component.json
Voir le fichier 

@@ -0,0 +1,19 @@
1 
+{
2 
+  "name": "select2",
3 
+  "repo": "select/select2",
4 
+  "description": "Select2 is a jQuery based replacement for select boxes. It supports searching, remote data sets, and infinite scrolling of results.",
5 
+  "version": "4.0.7",
6 
+  "demo": "https://select2.org/",
7 
+  "keywords": [
8 
+    "jquery"
9 
+  ],
10 
+  "main": "dist/js/select2.js",
11 
+  "styles": [
12 
+    "dist/css/select2.css"
13 
+  ],
14 
+  "scripts": [
15 
+    "dist/js/select2.js",
16 
+    "dist/js/i18n/*.js"
17 
+  ],
18 
+  "license": "MIT"
19 
+}

+ 22 - 0
app/staticfile/vendor/select2/composer.json
Voir le fichier 

@@ -0,0 +1,22 @@
1 
+{
2 
+  "name": "select2/select2",
3 
+  "description": "Select2 is a jQuery based replacement for select boxes.",
4 
+  "type": "component",
5 
+  "homepage": "https://select2.org/",
6 
+  "license": "MIT",
7 
+  "extra": {
8 
+    "component": {
9 
+      "scripts": [
10 
+        "dist/js/select2.js"
11 
+      ],
12 
+      "styles": [
13 
+        "dist/css/select2.css"
14 
+      ],
15 
+      "files": [
16 
+        "dist/js/select2.js",
17 
+        "dist/js/i18n/*.js",
18 
+        "dist/css/select2.css"
19 
+      ]
20 
+    }
21 
+  }
22 
+}

+ 484 - 0
app/staticfile/vendor/select2/dist/css/select2.css
Voir le fichier 

@@ -0,0 +1,484 @@
1 
+.select2-container {
2 
+  box-sizing: border-box;
3 
+  display: inline-block;
4 
+  margin: 0;
5 
+  position: relative;
6 
+  vertical-align: middle; }
7 
+  .select2-container .select2-selection--single {
8 
+    box-sizing: border-box;
9 
+    cursor: pointer;
10 
+    display: block;
11 
+    height: 28px;
12 
+    user-select: none;
13 
+    -webkit-user-select: none; }
14 
+    .select2-container .select2-selection--single .select2-selection__rendered {
15 
+      display: block;
16 
+      padding-left: 8px;
17 
+      padding-right: 20px;
18 
+      overflow: hidden;
19 
+      text-overflow: ellipsis;
20 
+      white-space: nowrap; }
21 
+    .select2-container .select2-selection--single .select2-selection__clear {
22 
+      position: relative; }
23 
+  .select2-container[dir="rtl"] .select2-selection--single .select2-selection__rendered {
24 
+    padding-right: 8px;
25 
+    padding-left: 20px; }
26 
+  .select2-container .select2-selection--multiple {
27 
+    box-sizing: border-box;
28 
+    cursor: pointer;
29 
+    display: block;
30 
+    min-height: 32px;
31 
+    user-select: none;
32 
+    -webkit-user-select: none; }
33 
+    .select2-container .select2-selection--multiple .select2-selection__rendered {
34 
+      display: inline-block;
35 
+      overflow: hidden;
36 
+      padding-left: 8px;
37 
+      text-overflow: ellipsis;
38 
+      white-space: nowrap; }
39 
+  .select2-container .select2-search--inline {
40 
+    float: left; }
41 
+    .select2-container .select2-search--inline .select2-search__field {
42 
+      box-sizing: border-box;
43 
+      border: none;
44 
+      font-size: 100%;
45 
+      margin-top: 5px;
46 
+      padding: 0; }
47 
+      .select2-container .select2-search--inline .select2-search__field::-webkit-search-cancel-button {
48 
+        -webkit-appearance: none; }
49 
+
50 
+.select2-dropdown {
51 
+  background-color: white;
52 
+  border: 1px solid #aaa;
53 
+  border-radius: 4px;
54 
+  box-sizing: border-box;
55 
+  display: block;
56 
+  position: absolute;
57 
+  left: -100000px;
58 
+  width: 100%;
59 
+  z-index: 1051; }
60 
+
61 
+.select2-results {
62 
+  display: block; }
63 
+
64 
+.select2-results__options {
65 
+  list-style: none;
66 
+  margin: 0;
67 
+  padding: 0; }
68 
+
69 
+.select2-results__option {
70 
+  padding: 6px;
71 
+  user-select: none;
72 
+  -webkit-user-select: none; }
73 
+  .select2-results__option[aria-selected] {
74 
+    cursor: pointer; }
75 
+
76 
+.select2-container--open .select2-dropdown {
77 
+  left: 0; }
78 
+
79 
+.select2-container--open .select2-dropdown--above {
80 
+  border-bottom: none;
81 
+  border-bottom-left-radius: 0;
82 
+  border-bottom-right-radius: 0; }
83 
+
84 
+.select2-container--open .select2-dropdown--below {
85 
+  border-top: none;
86 
+  border-top-left-radius: 0;
87 
+  border-top-right-radius: 0; }
88 
+
89 
+.select2-search--dropdown {
90 
+  display: block;
91 
+  padding: 4px; }
92 
+  .select2-search--dropdown .select2-search__field {
93 
+    padding: 4px;
94 
+    width: 100%;
95 
+    box-sizing: border-box; }
96 
+    .select2-search--dropdown .select2-search__field::-webkit-search-cancel-button {
97 
+      -webkit-appearance: none; }
98 
+  .select2-search--dropdown.select2-search--hide {
99 
+    display: none; }
100 
+
101 
+.select2-close-mask {
102 
+  border: 0;
103 
+  margin: 0;
104 
+  padding: 0;
105 
+  display: block;
106 
+  position: fixed;
107 
+  left: 0;
108 
+  top: 0;
109 
+  min-height: 100%;
110 
+  min-width: 100%;
111 
+  height: auto;
112 
+  width: auto;
113 
+  opacity: 0;
114 
+  z-index: 99;
115 
+  background-color: #fff;
116 
+  filter: alpha(opacity=0); }
117 
+
118 
+.select2-hidden-accessible {
119 
+  border: 0 !important;
120 
+  clip: rect(0 0 0 0) !important;
121 
+  -webkit-clip-path: inset(50%) !important;
122 
+  clip-path: inset(50%) !important;
123 
+  height: 1px !important;
124 
+  overflow: hidden !important;
125 
+  padding: 0 !important;
126 
+  position: absolute !important;
127 
+  width: 1px !important;
128 
+  white-space: nowrap !important; }
129 
+
130 
+.select2-container--default .select2-selection--single {
131 
+  background-color: #fff;
132 
+  border: 1px solid #aaa;
133 
+  border-radius: 4px; }
134 
+  .select2-container--default .select2-selection--single .select2-selection__rendered {
135 
+    color: #444;
136 
+    line-height: 28px; }
137 
+  .select2-container--default .select2-selection--single .select2-selection__clear {
138 
+    cursor: pointer;
139 
+    float: right;
140 
+    font-weight: bold; }
141 
+  .select2-container--default .select2-selection--single .select2-selection__placeholder {
142 
+    color: #999; }
143 
+  .select2-container--default .select2-selection--single .select2-selection__arrow {
144 
+    height: 26px;
145 
+    position: absolute;
146 
+    top: 1px;
147 
+    right: 1px;
148 
+    width: 20px; }
149 
+    .select2-container--default .select2-selection--single .select2-selection__arrow b {
150 
+      border-color: #888 transparent transparent transparent;
151 
+      border-style: solid;
152 
+      border-width: 5px 4px 0 4px;
153 
+      height: 0;
154 
+      left: 50%;
155 
+      margin-left: -4px;
156 
+      margin-top: -2px;
157 
+      position: absolute;
158 
+      top: 50%;
159 
+      width: 0; }
160 
+
161 
+.select2-container--default[dir="rtl"] .select2-selection--single .select2-selection__clear {
162 
+  float: left; }
163 
+
164 
+.select2-container--default[dir="rtl"] .select2-selection--single .select2-selection__arrow {
165 
+  left: 1px;
166 
+  right: auto; }
167 
+
168 
+.select2-container--default.select2-container--disabled .select2-selection--single {
169 
+  background-color: #eee;
170 
+  cursor: default; }
171 
+  .select2-container--default.select2-container--disabled .select2-selection--single .select2-selection__clear {
172 
+    display: none; }
173 
+
174 
+.select2-container--default.select2-container--open .select2-selection--single .select2-selection__arrow b {
175 
+  border-color: transparent transparent #888 transparent;
176 
+  border-width: 0 4px 5px 4px; }
177 
+
178 
+.select2-container--default .select2-selection--multiple {
179 
+  background-color: white;
180 
+  border: 1px solid #aaa;
181 
+  border-radius: 4px;
182 
+  cursor: text; }
183 
+  .select2-container--default .select2-selection--multiple .select2-selection__rendered {
184 
+    box-sizing: border-box;
185 
+    list-style: none;
186 
+    margin: 0;
187 
+    padding: 0 5px;
188 
+    width: 100%; }
189 
+    .select2-container--default .select2-selection--multiple .select2-selection__rendered li {
190 
+      list-style: none; }
191 
+  .select2-container--default .select2-selection--multiple .select2-selection__placeholder {
192 
+    color: #999;
193 
+    margin-top: 5px;
194 
+    float: left; }
195 
+  .select2-container--default .select2-selection--multiple .select2-selection__clear {
196 
+    cursor: pointer;
197 
+    float: right;
198 
+    font-weight: bold;
199 
+    margin-top: 5px;
200 
+    margin-right: 10px; }
201 
+  .select2-container--default .select2-selection--multiple .select2-selection__choice {
202 
+    background-color: #e4e4e4;
203 
+    border: 1px solid #aaa;
204 
+    border-radius: 4px;
205 
+    cursor: default;
206 
+    float: left;
207 
+    margin-right: 5px;
208 
+    margin-top: 5px;
209 
+    padding: 0 5px; }
210 
+  .select2-container--default .select2-selection--multiple .select2-selection__choice__remove {
211 
+    color: #999;
212 
+    cursor: pointer;
213 
+    display: inline-block;
214 
+    font-weight: bold;
215 
+    margin-right: 2px; }
216 
+    .select2-container--default .select2-selection--multiple .select2-selection__choice__remove:hover {
217 
+      color: #333; }
218 
+
219 
+.select2-container--default[dir="rtl"] .select2-selection--multiple .select2-selection__choice, .select2-container--default[dir="rtl"] .select2-selection--multiple .select2-selection__placeholder, .select2-container--default[dir="rtl"] .select2-selection--multiple .select2-search--inline {
220 
+  float: right; }
221 
+
222 
+.select2-container--default[dir="rtl"] .select2-selection--multiple .select2-selection__choice {
223 
+  margin-left: 5px;
224 
+  margin-right: auto; }
225 
+
226 
+.select2-container--default[dir="rtl"] .select2-selection--multiple .select2-selection__choice__remove {
227 
+  margin-left: 2px;
228 
+  margin-right: auto; }
229 
+
230 
+.select2-container--default.select2-container--focus .select2-selection--multiple {
231 
+  border: solid black 1px;
232 
+  outline: 0; }
233 
+
234 
+.select2-container--default.select2-container--disabled .select2-selection--multiple {
235 
+  background-color: #eee;
236 
+  cursor: default; }
237 
+
238 
+.select2-container--default.select2-container--disabled .select2-selection__choice__remove {
239 
+  display: none; }
240 
+
241 
+.select2-container--default.select2-container--open.select2-container--above .select2-selection--single, .select2-container--default.select2-container--open.select2-container--above .select2-selection--multiple {
242 
+  border-top-left-radius: 0;
243 
+  border-top-right-radius: 0; }
244 
+
245 
+.select2-container--default.select2-container--open.select2-container--below .select2-selection--single, .select2-container--default.select2-container--open.select2-container--below .select2-selection--multiple {
246 
+  border-bottom-left-radius: 0;
247 
+  border-bottom-right-radius: 0; }
248 
+
249 
+.select2-container--default .select2-search--dropdown .select2-search__field {
250 
+  border: 1px solid #aaa; }
251 
+
252 
+.select2-container--default .select2-search--inline .select2-search__field {
253 
+  background: transparent;
254 
+  border: none;
255 
+  outline: 0;
256 
+  box-shadow: none;
257 
+  -webkit-appearance: textfield; }
258 
+
259 
+.select2-container--default .select2-results > .select2-results__options {
260 
+  max-height: 200px;
261 
+  overflow-y: auto; }
262 
+
263 
+.select2-container--default .select2-results__option[role=group] {
264 
+  padding: 0; }
265 
+
266 
+.select2-container--default .select2-results__option[aria-disabled=true] {
267 
+  color: #999; }
268 
+
269 
+.select2-container--default .select2-results__option[aria-selected=true] {
270 
+  background-color: #ddd; }
271 
+
272 
+.select2-container--default .select2-results__option .select2-results__option {
273 
+  padding-left: 1em; }
274 
+  .select2-container--default .select2-results__option .select2-results__option .select2-results__group {
275 
+    padding-left: 0; }
276 
+  .select2-container--default .select2-results__option .select2-results__option .select2-results__option {
277 
+    margin-left: -1em;
278 
+    padding-left: 2em; }
279 
+    .select2-container--default .select2-results__option .select2-results__option .select2-results__option .select2-results__option {
280 
+      margin-left: -2em;
281 
+      padding-left: 3em; }
282 
+      .select2-container--default .select2-results__option .select2-results__option .select2-results__option .select2-results__option .select2-results__option {
283 
+        margin-left: -3em;
284 
+        padding-left: 4em; }
285 
+        .select2-container--default .select2-results__option .select2-results__option .select2-results__option .select2-results__option .select2-results__option .select2-results__option {
286 
+          margin-left: -4em;
287 
+          padding-left: 5em; }
288 
+          .select2-container--default .select2-results__option .select2-results__option .select2-results__option .select2-results__option .select2-results__option .select2-results__option .select2-results__option {
289 
+            margin-left: -5em;
290 
+            padding-left: 6em; }
291 
+
292 
+.select2-container--default .select2-results__option--highlighted[aria-selected] {
293 
+  background-color: #5897fb;
294 
+  color: white; }
295 
+
296 
+.select2-container--default .select2-results__group {
297 
+  cursor: default;
298 
+  display: block;
299 
+  padding: 6px; }
300 
+
301 
+.select2-container--classic .select2-selection--single {
302 
+  background-color: #f7f7f7;
303 
+  border: 1px solid #aaa;
304 
+  border-radius: 4px;
305 
+  outline: 0;
306 
+  background-image: -webkit-linear-gradient(top, white 50%, #eeeeee 100%);
307 
+  background-image: -o-linear-gradient(top, white 50%, #eeeeee 100%);
308 
+  background-image: linear-gradient(to bottom, white 50%, #eeeeee 100%);
309 
+  background-repeat: repeat-x;
310 
+  filter: progid:DXImageTransform.Microsoft.gradient(startColorstr='#FFFFFFFF', endColorstr='#FFEEEEEE', GradientType=0); }
311 
+  .select2-container--classic .select2-selection--single:focus {
312 
+    border: 1px solid #5897fb; }
313 
+  .select2-container--classic .select2-selection--single .select2-selection__rendered {
314 
+    color: #444;
315 
+    line-height: 28px; }
316 
+  .select2-container--classic .select2-selection--single .select2-selection__clear {
317 
+    cursor: pointer;
318 
+    float: right;
319 
+    font-weight: bold;
320 
+    margin-right: 10px; }
321 
+  .select2-container--classic .select2-selection--single .select2-selection__placeholder {
322 
+    color: #999; }
323 
+  .select2-container--classic .select2-selection--single .select2-selection__arrow {
324 
+    background-color: #ddd;
325 
+    border: none;
326 
+    border-left: 1px solid #aaa;
327 
+    border-top-right-radius: 4px;
328 
+    border-bottom-right-radius: 4px;
329 
+    height: 26px;
330 
+    position: absolute;
331 
+    top: 1px;
332 
+    right: 1px;
333 
+    width: 20px;
334 
+    background-image: -webkit-linear-gradient(top, #eeeeee 50%, #cccccc 100%);
335 
+    background-image: -o-linear-gradient(top, #eeeeee 50%, #cccccc 100%);
336 
+    background-image: linear-gradient(to bottom, #eeeeee 50%, #cccccc 100%);
337 
+    background-repeat: repeat-x;
338 
+    filter: progid:DXImageTransform.Microsoft.gradient(startColorstr='#FFEEEEEE', endColorstr='#FFCCCCCC', GradientType=0); }
339 
+    .select2-container--classic .select2-selection--single .select2-selection__arrow b {
340 
+      border-color: #888 transparent transparent transparent;
341 
+      border-style: solid;
342 
+      border-width: 5px 4px 0 4px;
343 
+      height: 0;
344 
+      left: 50%;
345 
+      margin-left: -4px;
346 
+      margin-top: -2px;
347 
+      position: absolute;
348 
+      top: 50%;
349 
+      width: 0; }
350 
+
351 
+.select2-container--classic[dir="rtl"] .select2-selection--single .select2-selection__clear {
352 
+  float: left; }
353 
+
354 
+.select2-container--classic[dir="rtl"] .select2-selection--single .select2-selection__arrow {
355 
+  border: none;
356 
+  border-right: 1px solid #aaa;
357 
+  border-radius: 0;
358 
+  border-top-left-radius: 4px;
359 
+  border-bottom-left-radius: 4px;
360 
+  left: 1px;
361 
+  right: auto; }
362 
+
363 
+.select2-container--classic.select2-container--open .select2-selection--single {
364 
+  border: 1px solid #5897fb; }
365 
+  .select2-container--classic.select2-container--open .select2-selection--single .select2-selection__arrow {
366 
+    background: transparent;
367 
+    border: none; }
368 
+    .select2-container--classic.select2-container--open .select2-selection--single .select2-selection__arrow b {
369 
+      border-color: transparent transparent #888 transparent;
370 
+      border-width: 0 4px 5px 4px; }
371 
+
372 
+.select2-container--classic.select2-container--open.select2-container--above .select2-selection--single {
373 
+  border-top: none;
374 
+  border-top-left-radius: 0;
375 
+  border-top-right-radius: 0;
376 
+  background-image: -webkit-linear-gradient(top, white 0%, #eeeeee 50%);
377 
+  background-image: -o-linear-gradient(top, white 0%, #eeeeee 50%);
378 
+  background-image: linear-gradient(to bottom, white 0%, #eeeeee 50%);
379 
+  background-repeat: repeat-x;
380 
+  filter: progid:DXImageTransform.Microsoft.gradient(startColorstr='#FFFFFFFF', endColorstr='#FFEEEEEE', GradientType=0); }
381 
+
382 
+.select2-container--classic.select2-container--open.select2-container--below .select2-selection--single {
383 
+  border-bottom: none;
384 
+  border-bottom-left-radius: 0;
385 
+  border-bottom-right-radius: 0;
386 
+  background-image: -webkit-linear-gradient(top, #eeeeee 50%, white 100%);
387 
+  background-image: -o-linear-gradient(top, #eeeeee 50%, white 100%);
388 
+  background-image: linear-gradient(to bottom, #eeeeee 50%, white 100%);
389 
+  background-repeat: repeat-x;
390 
+  filter: progid:DXImageTransform.Microsoft.gradient(startColorstr='#FFEEEEEE', endColorstr='#FFFFFFFF', GradientType=0); }
391 
+
392 
+.select2-container--classic .select2-selection--multiple {
393 
+  background-color: white;
394 
+  border: 1px solid #aaa;
395 
+  border-radius: 4px;
396 
+  cursor: text;
397 
+  outline: 0; }
398 
+  .select2-container--classic .select2-selection--multiple:focus {
399 
+    border: 1px solid #5897fb; }
400 
+  .select2-container--classic .select2-selection--multiple .select2-selection__rendered {
401 
+    list-style: none;
402 
+    margin: 0;
403 
+    padding: 0 5px; }
404 
+  .select2-container--classic .select2-selection--multiple .select2-selection__clear {
405 
+    display: none; }
406 
+  .select2-container--classic .select2-selection--multiple .select2-selection__choice {
407 
+    background-color: #e4e4e4;
408 
+    border: 1px solid #aaa;
409 
+    border-radius: 4px;
410 
+    cursor: default;
411 
+    float: left;
412 
+    margin-right: 5px;
413 
+    margin-top: 5px;
414 
+    padding: 0 5px; }
415 
+  .select2-container--classic .select2-selection--multiple .select2-selection__choice__remove {
416 
+    color: #888;
417 
+    cursor: pointer;
418 
+    display: inline-block;
419 
+    font-weight: bold;
420 
+    margin-right: 2px; }
421 
+    .select2-container--classic .select2-selection--multiple .select2-selection__choice__remove:hover {
422 
+      color: #555; }
423 
+
424 
+.select2-container--classic[dir="rtl"] .select2-selection--multiple .select2-selection__choice {
425 
+  float: right;
426 
+  margin-left: 5px;
427 
+  margin-right: auto; }
428 
+
429 
+.select2-container--classic[dir="rtl"] .select2-selection--multiple .select2-selection__choice__remove {
430 
+  margin-left: 2px;
431 
+  margin-right: auto; }
432 
+
433 
+.select2-container--classic.select2-container--open .select2-selection--multiple {
434 
+  border: 1px solid #5897fb; }
435 
+
436 
+.select2-container--classic.select2-container--open.select2-container--above .select2-selection--multiple {
437 
+  border-top: none;
438 
+  border-top-left-radius: 0;
439 
+  border-top-right-radius: 0; }
440 
+
441 
+.select2-container--classic.select2-container--open.select2-container--below .select2-selection--multiple {
442 
+  border-bottom: none;
443 
+  border-bottom-left-radius: 0;
444 
+  border-bottom-right-radius: 0; }
445 
+
446 
+.select2-container--classic .select2-search--dropdown .select2-search__field {
447 
+  border: 1px solid #aaa;
448 
+  outline: 0; }
449 
+
450 
+.select2-container--classic .select2-search--inline .select2-search__field {
451 
+  outline: 0;
452 
+  box-shadow: none; }
453 
+
454 
+.select2-container--classic .select2-dropdown {
455 
+  background-color: white;
456 
+  border: 1px solid transparent; }
457 
+
458 
+.select2-container--classic .select2-dropdown--above {
459 
+  border-bottom: none; }
460 
+
461 
+.select2-container--classic .select2-dropdown--below {
462 
+  border-top: none; }
463 
+
464 
+.select2-container--classic .select2-results > .select2-results__options {
465 
+  max-height: 200px;
466 
+  overflow-y: auto; }
467 
+
468 
+.select2-container--classic .select2-results__option[role=group] {
469 
+  padding: 0; }
470 
+
471 
+.select2-container--classic .select2-results__option[aria-disabled=true] {
472 
+  color: grey; }
473 
+
474 
+.select2-container--classic .select2-results__option--highlighted[aria-selected] {
475 
+  background-color: #3875d7;
476 
+  color: white; }
477 
+
478 
+.select2-container--classic .select2-results__group {
479 
+  cursor: default;
480 
+  display: block;
481 
+  padding: 6px; }
482 
+
483 
+.select2-container--classic.select2-container--open .select2-dropdown {
484 
+  border-color: #5897fb; }

Fichier diff supprimé car celui-ci est trop grand
+ 1 - 0
app/staticfile/vendor/select2/dist/css/select2.min.css


Fichier diff supprimé car celui-ci est trop grand
+ 3 - 0
app/staticfile/vendor/select2/dist/js/i18n/af.js


Fichier diff supprimé car celui-ci est trop grand
+ 3 - 0
app/staticfile/vendor/select2/dist/js/i18n/ar.js


Fichier diff supprimé car celui-ci est trop grand
+ 3 - 0
app/staticfile/vendor/select2/dist/js/i18n/az.js


Fichier diff supprimé car celui-ci est trop grand
+ 3 - 0
app/staticfile/vendor/select2/dist/js/i18n/bg.js


Fichier diff supprimé car celui-ci est trop grand
+ 3 - 0
app/staticfile/vendor/select2/dist/js/i18n/bn.js


Fichier diff supprimé car celui-ci est trop grand
+ 3 - 0
app/staticfile/vendor/select2/dist/js/i18n/bs.js


Fichier diff supprimé car celui-ci est trop grand
+ 3 - 0
app/staticfile/vendor/select2/dist/js/i18n/ca.js


Fichier diff supprimé car celui-ci est trop grand
+ 3 - 0
app/staticfile/vendor/select2/dist/js/i18n/cs.js


Fichier diff supprimé car celui-ci est trop grand
+ 3 - 0
app/staticfile/vendor/select2/dist/js/i18n/da.js


Fichier diff supprimé car celui-ci est trop grand
+ 3 - 0
app/staticfile/vendor/select2/dist/js/i18n/de.js


Fichier diff supprimé car celui-ci est trop grand
+ 3 - 0
app/staticfile/vendor/select2/dist/js/i18n/dsb.js


Fichier diff supprimé car celui-ci est trop grand
+ 3 - 0
app/staticfile/vendor/select2/dist/js/i18n/el.js


Fichier diff supprimé car celui-ci est trop grand
+ 3 - 0
app/staticfile/vendor/select2/dist/js/i18n/en.js


Fichier diff supprimé car celui-ci est trop grand
+ 3 - 0
app/staticfile/vendor/select2/dist/js/i18n/es.js


Fichier diff supprimé car celui-ci est trop grand
+ 3 - 0
app/staticfile/vendor/select2/dist/js/i18n/et.js


Fichier diff supprimé car celui-ci est trop grand
+ 3 - 0
app/staticfile/vendor/select2/dist/js/i18n/eu.js


Fichier diff supprimé car celui-ci est trop grand
+ 3 - 0
app/staticfile/vendor/select2/dist/js/i18n/fa.js


Fichier diff supprimé car celui-ci est trop grand
+ 3 - 0
app/staticfile/vendor/select2/dist/js/i18n/fi.js


Fichier diff supprimé car celui-ci est trop grand
+ 3 - 0
app/staticfile/vendor/select2/dist/js/i18n/fr.js


Fichier diff supprimé car celui-ci est trop grand
+ 3 - 0
app/staticfile/vendor/select2/dist/js/i18n/gl.js


Fichier diff supprimé car celui-ci est trop grand
+ 3 - 0
app/staticfile/vendor/select2/dist/js/i18n/he.js


Fichier diff supprimé car celui-ci est trop grand
+ 3 - 0
app/staticfile/vendor/select2/dist/js/i18n/hi.js


Fichier diff supprimé car celui-ci est trop grand
+ 3 - 0
app/staticfile/vendor/select2/dist/js/i18n/hr.js


Fichier diff supprimé car celui-ci est trop grand
+ 3 - 0
app/staticfile/vendor/select2/dist/js/i18n/hsb.js


+ 0 - 0
app/staticfile/vendor/select2/dist/js/i18n/hu.js
Voir le fichier


Certains fichiers n'ont pas été affichés car il y a eu trop de fichiers modifiés dans ce diff

tum/whitesports - Gogs: Simplico Git Service
Home Verkennen Help
Inloggen
tum
/
whitesports
Volgen 1
Ster 0
Vork 0
Code Kwesties 0 Pull-aanvragen 0 Commits 5 Publicaties 0 Wiki

Geen omschrijving

Boom: 0b697c9ce1
Aftakkingen Labels
whitesports
/
app
/
wp-includes
/
option.php

option.php 75KB
Geschiedenis Ruwe

1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950515253545556575859606162636465666768697071727374757677787980818283848586878889909192939495969798991001011021031041051061071081091101111121131141151161171181191201211221231241251261271281291301311321331341351361371381391401411421431441451461471481491501511521531541551561571581591601611621631641651661671681691701711721731741751761771781791801811821831841851861871881891901911921931941951961971981992002012022032042052062072082092102112122132142152162172182192202212222232242252262272282292302312322332342352362372382392402412422432442452462472482492502512522532542552562572582592602612622632642652662672682692702712722732742752762772782792802812822832842852862872882892902912922932942952962972982993003013023033043053063073083093103113123133143153163173183193203213223233243253263273283293303313323333343353363373383393403413423433443453463473483493503513523533543553563573583593603613623633643653663673683693703713723733743753763773783793803813823833843853863873883893903913923933943953963973983994004014024034044054064074084094104114124134144154164174184194204214224234244254264274284294304314324334344354364374384394404414424434444454464474484494504514524534544554564574584594604614624634644654664674684694704714724734744754764774784794804814824834844854864874884894904914924934944954964974984995005015025035045055065075085095105115125135145155165175185195205215225235245255265275285295305315325335345355365375385395405415425435445455465475485495505515525535545555565575585595605615625635645655665675685695705715725735745755765775785795805815825835845855865875885895905915925935945955965975985996006016026036046056066076086096106116126136146156166176186196206216226236246256266276286296306316326336346356366376386396406416426436446456466476486496506516526536546556566576586596606616626636646656666676686696706716726736746756766776786796806816826836846856866876886896906916926936946956966976986997007017027037047057067077087097107117127137147157167177187197207217227237247257267277287297307317327337347357367377387397407417427437447457467477487497507517527537547557567577587597607617627637647657667677687697707717727737747757767777787797807817827837847857867877887897907917927937947957967977987998008018028038048058068078088098108118128138148158168178188198208218228238248258268278288298308318328338348358368378388398408418428438448458468478488498508518528538548558568578588598608618628638648658668678688698708718728738748758768778788798808818828838848858868878888898908918928938948958968978988999009019029039049059069079089099109119129139149159169179189199209219229239249259269279289299309319329339349359369379389399409419429439449459469479489499509519529539549559569579589599609619629639649659669679689699709719729739749759769779789799809819829839849859869879889899909919929939949959969979989991000100110021003100410051006100710081009101010111012101310141015101610171018101910201021102210231024102510261027102810291030103110321033103410351036103710381039104010411042104310441045104610471048104910501051105210531054105510561057105810591060106110621063106410651066106710681069107010711072107310741075107610771078107910801081108210831084108510861087108810891090109110921093109410951096109710981099110011011102110311041105110611071108110911101111111211131114111511161117111811191120112111221123112411251126112711281129113011311132113311341135113611371138113911401141114211431144114511461147114811491150115111521153115411551156115711581159116011611162116311641165116611671168116911701171117211731174117511761177117811791180118111821183118411851186118711881189119011911192119311941195119611971198119912001201120212031204120512061207120812091210121112121213121412151216121712181219122012211222122312241225122612271228122912301231123212331234123512361237123812391240124112421243124412451246124712481249125012511252125312541255125612571258125912601261126212631264126512661267126812691270127112721273127412751276127712781279128012811282128312841285128612871288128912901291129212931294129512961297129812991300130113021303130413051306130713081309131013111312131313141315131613171318131913201321132213231324132513261327132813291330133113321333133413351336133713381339134013411342134313441345134613471348134913501351135213531354135513561357135813591360136113621363136413651366136713681369137013711372137313741375137613771378137913801381138213831384138513861387138813891390139113921393139413951396139713981399140014011402140314041405140614071408140914101411141214131414141514161417141814191420142114221423142414251426142714281429143014311432143314341435143614371438143914401441144214431444144514461447144814491450145114521453145414551456145714581459146014611462146314641465146614671468146914701471147214731474147514761477147814791480148114821483148414851486148714881489149014911492149314941495149614971498149915001501150215031504150515061507150815091510151115121513151415151516151715181519152015211522152315241525152615271528152915301531153215331534153515361537153815391540154115421543154415451546154715481549155015511552155315541555155615571558155915601561156215631564156515661567156815691570157115721573157415751576157715781579158015811582158315841585158615871588158915901591159215931594159515961597159815991600160116021603160416051606160716081609161016111612161316141615161616171618161916201621162216231624162516261627162816291630163116321633163416351636163716381639164016411642164316441645164616471648164916501651165216531654165516561657165816591660166116621663166416651666166716681669167016711672167316741675167616771678167916801681168216831684168516861687168816891690169116921693169416951696169716981699170017011702170317041705170617071708170917101711171217131714171517161717171817191720172117221723172417251726172717281729173017311732173317341735173617371738173917401741174217431744174517461747174817491750175117521753175417551756175717581759176017611762176317641765176617671768176917701771177217731774177517761777177817791780178117821783178417851786178717881789179017911792179317941795179617971798179918001801180218031804180518061807180818091810181118121813181418151816181718181819182018211822182318241825182618271828182918301831183218331834183518361837183818391840184118421843184418451846184718481849185018511852185318541855185618571858185918601861186218631864186518661867186818691870187118721873187418751876187718781879188018811882188318841885188618871888188918901891189218931894189518961897189818991900190119021903190419051906190719081909191019111912191319141915191619171918191919201921192219231924192519261927192819291930193119321933193419351936193719381939194019411942194319441945194619471948194919501951195219531954195519561957195819591960196119621963196419651966196719681969197019711972197319741975197619771978197919801981198219831984198519861987198819891990199119921993199419951996199719981999200020012002200320042005200620072008200920102011201220132014201520162017201820192020202120222023202420252026202720282029203020312032203320342035203620372038203920402041204220432044204520462047204820492050205120522053205420552056205720582059206020612062206320642065206620672068206920702071207220732074207520762077207820792080208120822083208420852086208720882089209020912092209320942095209620972098209921002101210221032104210521062107210821092110211121122113211421152116211721182119212021212122212321242125212621272128212921302131213221332134213521362137213821392140214121422143214421452146214721482149215021512152215321542155215621572158215921602161216221632164216521662167216821692170217121722173217421752176217721782179218021812182218321842185218621872188218921902191219221932194219521962197219821992200220122022203220422052206220722082209221022112212221322142215221622172218221922202221222222232224222522262227222822292230223122322233223422352236223722382239224022412242224322442245224622472248224922502251225222532254225522562257225822592260226122622263226422652266226722682269227022712272227322742275227622772278227922802281228222832284228522862287228822892290229122922293229422952296229722982299230023012302230323042305230623072308230923102311231223132314231523162317231823192320232123222323232423252326232723282329233023312332233323342335233623372338233923402341234223432344234523462347234823492350235123522353235423552356235723582359236023612362236323642365236623672368236923702371237223732374237523762377237823792380238123822383238423852386238723882389239023912392239323942395239623972398239924002401240224032404240524062407240824092410241124122413241424152416241724182419242024212422242324242425242624272428242924302431243224332434243524362437243824392440244124422443244424452446244724482449245024512452245324542455245624572458245924602461246224632464246524662467246824692470247124722473247424752476247724782479248024812482248324842485248624872488248924902491249224932494249524962497249824992500 
  1. <?php
    2. 

  2. /**
    3. 

  3.  * Option API
    4. 

  4.  *
    5. 

  5.  * @package WordPress
    6. 

  6.  * @subpackage Option
    7. 

  7.  */
    8. 

  8. 

  9. /**
    10. 

  10.  * Retrieves an option value based on an option name.
    11. 

  11.  *
    12. 

  12.  * If the option does not exist, and a default value is not provided,
    13. 

  13.  * boolean false is returned. This could be used to check whether you need
    14. 

  14.  * to initialize an option during installation of a plugin, however that
    15. 

  15.  * can be done better by using add_option() which will not overwrite
    16. 

  16.  * existing options.
    17. 

  17.  *
    18. 

  18.  * Not initializing an option and using boolean `false` as a return value
    19. 

  19.  * is a bad practice as it triggers an additional database query.
    20. 

  20.  *
    21. 

  21.  * The type of the returned value can be different from the type that was passed
    22. 

  22.  * when saving or updating the option. If the option value was serialized,
    23. 

  23.  * then it will be unserialized when it is returned. In this case the type will
    24. 

  24.  * be the same. For example, storing a non-scalar value like an array will
    25. 

  25.  * return the same array.
    26. 

  26.  *
    27. 

  27.  * In most cases non-string scalar and null values will be converted and returned
    28. 

  28.  * as string equivalents.
    29. 

  29.  *
    30. 

  30.  * Exceptions:
    31. 

  31.  * 1. When the option has not been saved in the database, the `$default` value
    32. 

  32.  *    is returned if provided. If not, boolean `false` is returned.
    33. 

  33.  * 2. When one of the Options API filters is used: {@see 'pre_option_{$option}'},
    34. 

  34.  *    {@see 'default_option_{$option}'}, or {@see 'option_{$option}'}, the returned
    35. 

  35.  *    value may not match the expected type.
    36. 

  36.  * 3. When the option has just been saved in the database, and get_option()
    37. 

  37.  *    is used right after, non-string scalar and null values are not converted to
    38. 

  38.  *    string equivalents and the original type is returned.
    39. 

  39.  *
    40. 

  40.  * Examples:
    41. 

  41.  *
    42. 

  42.  * When adding options like this: `add_option( 'my_option_name', 'value' );`
    43. 

  43.  * and then retrieving them with `get_option( 'my_option_name' );`, the returned
    44. 

  44.  * values will be:
    45. 

  45.  *
    46. 

  46.  * `false` returns `string(0) ""`
    47. 

  47.  * `true`  returns `string(1) "1"`
    48. 

  48.  * `0`     returns `string(1) "0"`
    49. 

  49.  * `1`     returns `string(1) "1"`
    50. 

  50.  * `'0'`   returns `string(1) "0"`
    51. 

  51.  * `'1'`   returns `string(1) "1"`
    52. 

  52.  * `null`  returns `string(0) ""`
    53. 

  53.  *
    54. 

  54.  * When adding options with non-scalar values like
    55. 

  55.  * `add_option( 'my_array', array( false, 'str', null ) );`, the returned value
    56. 

  56.  * will be identical to the original as it is serialized before saving
    57. 

  57.  * it in the database:
    58. 

  58.  *
    59. 

  59.  *    array(3) {
    60. 

  60.  *        [0] => bool(false)
    61. 

  61.  *        [1] => string(3) "str"
    62. 

  62.  *        [2] => NULL
    63. 

  63.  *    }
    64. 

  64.  *
    65. 

  65.  * @since 1.5.0
    66. 

  66.  *
    67. 

  67.  * @global wpdb $wpdb WordPress database abstraction object.
    68. 

  68.  *
    69. 

  69.  * @param string $option  Name of the option to retrieve. Expected to not be SQL-escaped.
    70. 

  70.  * @param mixed  $default Optional. Default value to return if the option does not exist.
    71. 

  71.  * @return mixed Value of the option. A value of any type may be returned, including
    72. 

  72.  *               scalar (string, boolean, float, integer), null, array, object.
    73. 

  73.  *               Scalar and null values will be returned as strings as long as they originate
    74. 

  74.  *               from a database stored option value. If there is no option in the database,
    75. 

  75.  *               boolean `false` is returned.
    76. 

  76.  */
    77. 

  77. function get_option( $option, $default = false ) {
    78. 

  78. 	global $wpdb;
    79. 

  79. 

  80. 	$option = trim( $option );
    81. 

  81. 	if ( empty( $option ) ) {
    82. 

  82. 		return false;
    83. 

  83. 	}
    84. 

  84. 

  85. 	/*
    86. 

  86. 	 * Until a proper _deprecated_option() function can be introduced,
    87. 

  87. 	 * redirect requests to deprecated keys to the new, correct ones.
    88. 

  88. 	 */
    89. 

  89. 	$deprecated_keys = array(
    90. 

  90. 		'blacklist_keys'    => 'disallowed_keys',
    91. 

  91. 		'comment_whitelist' => 'comment_previously_approved',
    92. 

  92. 	);
    93. 

  93. 

  94. 	if ( ! wp_installing() && isset( $deprecated_keys[ $option ] ) ) {
    95. 

  95. 		_deprecated_argument(
    96. 

  96. 			__FUNCTION__,
    97. 

  97. 			'5.5.0',
    98. 

  98. 			sprintf(
    99. 

  99. 				/* translators: 1: Deprecated option key, 2: New option key. */
    100. 

  100. 				__( 'The "%1$s" option key has been renamed to "%2$s".' ),
    101. 

  101. 				$option,
    102. 

  102. 				$deprecated_keys[ $option ]
    103. 

  103. 			)
    104. 

  104. 		);
    105. 

  105. 		return get_option( $deprecated_keys[ $option ], $default );
    106. 

  106. 	}
    107. 

  107. 

  108. 	/**
    109. 

  109. 	 * Filters the value of an existing option before it is retrieved.
    110. 

  110. 	 *
    111. 

  111. 	 * The dynamic portion of the hook name, `$option`, refers to the option name.
    112. 

  112. 	 *
    113. 

  113. 	 * Returning a truthy value from the filter will effectively short-circuit retrieval
    114. 

  114. 	 * and return the passed value instead.
    115. 

  115. 	 *
    116. 

  116. 	 * @since 1.5.0
    117. 

  117. 	 * @since 4.4.0 The `$option` parameter was added.
    118. 

  118. 	 * @since 4.9.0 The `$default` parameter was added.
    119. 

  119. 	 *
    120. 

  120. 	 * @param mixed  $pre_option The value to return instead of the option value. This differs
    121. 

  121. 	 *                           from `$default`, which is used as the fallback value in the event
    122. 

  122. 	 *                           the option doesn't exist elsewhere in get_option().
    123. 

  123. 	 *                           Default false (to skip past the short-circuit).
    124. 

  124. 	 * @param string $option     Option name.
    125. 

  125. 	 * @param mixed  $default    The fallback value to return if the option does not exist.
    126. 

  126. 	 *                           Default false.
    127. 

  127. 	 */
    128. 

  128. 	$pre = apply_filters( "pre_option_{$option}", false, $option, $default );
    129. 

  129. 

  130. 	if ( false !== $pre ) {
    131. 

  131. 		return $pre;
    132. 

  132. 	}
    133. 

  133. 

  134. 	if ( defined( 'WP_SETUP_CONFIG' ) ) {
    135. 

  135. 		return false;
    136. 

  136. 	}
    137. 

  137. 

  138. 	// Distinguish between `false` as a default, and not passing one.
    139. 

  139. 	$passed_default = func_num_args() > 1;
    140. 

  140. 

  141. 	if ( ! wp_installing() ) {
    142. 

  142. 		// Prevent non-existent options from triggering multiple queries.
    143. 

  143. 		$notoptions = wp_cache_get( 'notoptions', 'options' );
    144. 

  144. 

  145. 		if ( isset( $notoptions[ $option ] ) ) {
    146. 

  146. 			/**
    147. 

  147. 			 * Filters the default value for an option.
    148. 

  148. 			 *
    149. 

  149. 			 * The dynamic portion of the hook name, `$option`, refers to the option name.
    150. 

  150. 			 *
    151. 

  151. 			 * @since 3.4.0
    152. 

  152. 			 * @since 4.4.0 The `$option` parameter was added.
    153. 

  153. 			 * @since 4.7.0 The `$passed_default` parameter was added to distinguish between a `false` value and the default parameter value.
    154. 

  154. 			 *
    155. 

  155. 			 * @param mixed  $default The default value to return if the option does not exist
    156. 

  156. 			 *                        in the database.
    157. 

  157. 			 * @param string $option  Option name.
    158. 

  158. 			 * @param bool   $passed_default Was `get_option()` passed a default value?
    159. 

  159. 			 */
    160. 

  160. 			return apply_filters( "default_option_{$option}", $default, $option, $passed_default );
    161. 

  161. 		}
    162. 

  162. 

  163. 		$alloptions = wp_load_alloptions();
    164. 

  164. 

  165. 		if ( isset( $alloptions[ $option ] ) ) {
    166. 

  166. 			$value = $alloptions[ $option ];
    167. 

  167. 		} else {
    168. 

  168. 			$value = wp_cache_get( $option, 'options' );
    169. 

  169. 

  170. 			if ( false === $value ) {
    171. 

  171. 				$row = $wpdb->get_row( $wpdb->prepare( "SELECT option_value FROM $wpdb->options WHERE option_name = %s LIMIT 1", $option ) );
    172. 

  172. 

  173. 				// Has to be get_row() instead of get_var() because of funkiness with 0, false, null values.
    174. 

  174. 				if ( is_object( $row ) ) {
    175. 

  175. 					$value = $row->option_value;
    176. 

  176. 					wp_cache_add( $option, $value, 'options' );
    177. 

  177. 				} else { // Option does not exist, so we must cache its non-existence.
    178. 

  178. 					if ( ! is_array( $notoptions ) ) {
    179. 

  179. 						$notoptions = array();
    180. 

  180. 					}
    181. 

  181. 

  182. 					$notoptions[ $option ] = true;
    183. 

  183. 					wp_cache_set( 'notoptions', $notoptions, 'options' );
    184. 

  184. 

  185. 					/** This filter is documented in wp-includes/option.php */
    186. 

  186. 					return apply_filters( "default_option_{$option}", $default, $option, $passed_default );
    187. 

  187. 				}
    188. 

  188. 			}
    189. 

  189. 		}
    190. 

  190. 	} else {
    191. 

  191. 		$suppress = $wpdb->suppress_errors();
    192. 

  192. 		$row      = $wpdb->get_row( $wpdb->prepare( "SELECT option_value FROM $wpdb->options WHERE option_name = %s LIMIT 1", $option ) );
    193. 

  193. 		$wpdb->suppress_errors( $suppress );
    194. 

  194. 

  195. 		if ( is_object( $row ) ) {
    196. 

  196. 			$value = $row->option_value;
    197. 

  197. 		} else {
    198. 

  198. 			/** This filter is documented in wp-includes/option.php */
    199. 

  199. 			return apply_filters( "default_option_{$option}", $default, $option, $passed_default );
    200. 

  200. 		}
    201. 

  201. 	}
    202. 

  202. 

  203. 	// If home is not set, use siteurl.
    204. 

  204. 	if ( 'home' === $option && '' === $value ) {
    205. 

  205. 		return get_option( 'siteurl' );
    206. 

  206. 	}
    207. 

  207. 

  208. 	if ( in_array( $option, array( 'siteurl', 'home', 'category_base', 'tag_base' ), true ) ) {
    209. 

  209. 		$value = untrailingslashit( $value );
    210. 

  210. 	}
    211. 

  211. 

  212. 	/**
    213. 

  213. 	 * Filters the value of an existing option.
    214. 

  214. 	 *
    215. 

  215. 	 * The dynamic portion of the hook name, `$option`, refers to the option name.
    216. 

  216. 	 *
    217. 

  217. 	 * @since 1.5.0 As 'option_' . $setting
    218. 

  218. 	 * @since 3.0.0
    219. 

  219. 	 * @since 4.4.0 The `$option` parameter was added.
    220. 

  220. 	 *
    221. 

  221. 	 * @param mixed  $value  Value of the option. If stored serialized, it will be
    222. 

  222. 	 *                       unserialized prior to being returned.
    223. 

  223. 	 * @param string $option Option name.
    224. 

  224. 	 */
    225. 

  225. 	return apply_filters( "option_{$option}", maybe_unserialize( $value ), $option );
    226. 

  226. }
    227. 

  227. 

  228. /**
    229. 

  229.  * Protects WordPress special option from being modified.
    230. 

  230.  *
    231. 

  231.  * Will die if $option is in protected list. Protected options are 'alloptions'
    232. 

  232.  * and 'notoptions' options.
    233. 

  233.  *
    234. 

  234.  * @since 2.2.0
    235. 

  235.  *
    236. 

  236.  * @param string $option Option name.
    237. 

  237.  */
    238. 

  238. function wp_protect_special_option( $option ) {
    239. 

  239. 	if ( 'alloptions' === $option || 'notoptions' === $option ) {
    240. 

  240. 		wp_die(
    241. 

  241. 			sprintf(
    242. 

  242. 				/* translators: %s: Option name. */
    243. 

  243. 				__( '%s is a protected WP option and may not be modified' ),
    244. 

  244. 				esc_html( $option )
    245. 

  245. 			)
    246. 

  246. 		);
    247. 

  247. 	}
    248. 

  248. }
    249. 

  249. 

  250. /**
    251. 

  251.  * Prints option value after sanitizing for forms.
    252. 

  252.  *
    253. 

  253.  * @since 1.5.0
    254. 

  254.  *
    255. 

  255.  * @param string $option Option name.
    256. 

  256.  */
    257. 

  257. function form_option( $option ) {
    258. 

  258. 	echo esc_attr( get_option( $option ) );
    259. 

  259. }
    260. 

  260. 

  261. /**
    262. 

  262.  * Loads and caches all autoloaded options, if available or all options.
    263. 

  263.  *
    264. 

  264.  * @since 2.2.0
    265. 

  265.  * @since 5.3.1 The `$force_cache` parameter was added.
    266. 

  266.  *
    267. 

  267.  * @global wpdb $wpdb WordPress database abstraction object.
    268. 

  268.  *
    269. 

  269.  * @param bool $force_cache Optional. Whether to force an update of the local cache
    270. 

  270.  *                          from the persistent cache. Default false.
    271. 

  271.  * @return array List of all options.
    272. 

  272.  */
    273. 

  273. function wp_load_alloptions( $force_cache = false ) {
    274. 

  274. 	global $wpdb;
    275. 

  275. 

  276. 	if ( ! wp_installing() || ! is_multisite() ) {
    277. 

  277. 		$alloptions = wp_cache_get( 'alloptions', 'options', $force_cache );
    278. 

  278. 	} else {
    279. 

  279. 		$alloptions = false;
    280. 

  280. 	}
    281. 

  281. 

  282. 	if ( ! $alloptions ) {
    283. 

  283. 		$suppress      = $wpdb->suppress_errors();
    284. 

  284. 		$alloptions_db = $wpdb->get_results( "SELECT option_name, option_value FROM $wpdb->options WHERE autoload = 'yes'" );
    285. 

  285. 		if ( ! $alloptions_db ) {
    286. 

  286. 			$alloptions_db = $wpdb->get_results( "SELECT option_name, option_value FROM $wpdb->options" );
    287. 

  287. 		}
    288. 

  288. 		$wpdb->suppress_errors( $suppress );
    289. 

  289. 

  290. 		$alloptions = array();
    291. 

  291. 		foreach ( (array) $alloptions_db as $o ) {
    292. 

  292. 			$alloptions[ $o->option_name ] = $o->option_value;
    293. 

  293. 		}
    294. 

  294. 

  295. 		if ( ! wp_installing() || ! is_multisite() ) {
    296. 

  296. 			/**
    297. 

  297. 			 * Filters all options before caching them.
    298. 

  298. 			 *
    299. 

  299. 			 * @since 4.9.0
    300. 

  300. 			 *
    301. 

  301. 			 * @param array $alloptions Array with all options.
    302. 

  302. 			 */
    303. 

  303. 			$alloptions = apply_filters( 'pre_cache_alloptions', $alloptions );
    304. 

  304. 

  305. 			wp_cache_add( 'alloptions', $alloptions, 'options' );
    306. 

  306. 		}
    307. 

  307. 	}
    308. 

  308. 

  309. 	/**
    310. 

  310. 	 * Filters all options after retrieving them.
    311. 

  311. 	 *
    312. 

  312. 	 * @since 4.9.0
    313. 

  313. 	 *
    314. 

  314. 	 * @param array $alloptions Array with all options.
    315. 

  315. 	 */
    316. 

  316. 	return apply_filters( 'alloptions', $alloptions );
    317. 

  317. }
    318. 

  318. 

  319. /**
    320. 

  320.  * Loads and caches certain often requested site options if is_multisite() and a persistent cache is not being used.
    321. 

  321.  *
    322. 

  322.  * @since 3.0.0
    323. 

  323.  *
    324. 

  324.  * @global wpdb $wpdb WordPress database abstraction object.
    325. 

  325.  *
    326. 

  326.  * @param int $network_id Optional site ID for which to query the options. Defaults to the current site.
    327. 

  327.  */
    328. 

  328. function wp_load_core_site_options( $network_id = null ) {
    329. 

  329. 	global $wpdb;
    330. 

  330. 

  331. 	if ( ! is_multisite() || wp_using_ext_object_cache() || wp_installing() ) {
    332. 

  332. 		return;
    333. 

  333. 	}
    334. 

  334. 

  335. 	if ( empty( $network_id ) ) {
    336. 

  336. 		$network_id = get_current_network_id();
    337. 

  337. 	}
    338. 

  338. 

  339. 	$core_options = array( 'site_name', 'siteurl', 'active_sitewide_plugins', '_site_transient_timeout_theme_roots', '_site_transient_theme_roots', 'site_admins', 'can_compress_scripts', 'global_terms_enabled', 'ms_files_rewriting' );
    340. 

  340. 

  341. 	$core_options_in = "'" . implode( "', '", $core_options ) . "'";
    342. 

  342. 	$options         = $wpdb->get_results( $wpdb->prepare( "SELECT meta_key, meta_value FROM $wpdb->sitemeta WHERE meta_key IN ($core_options_in) AND site_id = %d", $network_id ) );
    343. 

  343. 

  344. 	foreach ( $options as $option ) {
    345. 

  345. 		$key                = $option->meta_key;
    346. 

  346. 		$cache_key          = "{$network_id}:$key";
    347. 

  347. 		$option->meta_value = maybe_unserialize( $option->meta_value );
    348. 

  348. 

  349. 		wp_cache_set( $cache_key, $option->meta_value, 'site-options' );
    350. 

  350. 	}
    351. 

  351. }
    352. 

  352. 

  353. /**
    354. 

  354.  * Updates the value of an option that was already added.
    355. 

  355.  *
    356. 

  356.  * You do not need to serialize values. If the value needs to be serialized,
    357. 

  357.  * then it will be serialized before it is inserted into the database.
    358. 

  358.  * Remember, resources cannot be serialized or added as an option.
    359. 

  359.  *
    360. 

  360.  * If the option does not exist, it will be created.
    361. 

  361. 

  362.  * This function is designed to work with or without a logged-in user. In terms of security,
    363. 

  363.  * plugin developers should check the current user's capabilities before updating any options.
    364. 

  364.  *
    365. 

  365.  * @since 1.0.0
    366. 

  366.  * @since 4.2.0 The `$autoload` parameter was added.
    367. 

  367.  *
    368. 

  368.  * @global wpdb $wpdb WordPress database abstraction object.
    369. 

  369.  *
    370. 

  370.  * @param string      $option   Name of the option to update. Expected to not be SQL-escaped.
    371. 

  371.  * @param mixed       $value    Option value. Must be serializable if non-scalar. Expected to not be SQL-escaped.
    372. 

  372.  * @param string|bool $autoload Optional. Whether to load the option when WordPress starts up. For existing options,
    373. 

  373.  *                              `$autoload` can only be updated using `update_option()` if `$value` is also changed.
    374. 

  374.  *                              Accepts 'yes'|true to enable or 'no'|false to disable. For non-existent options,
    375. 

  375.  *                              the default value is 'yes'. Default null.
    376. 

  376.  * @return bool True if the value was updated, false otherwise.
    377. 

  377.  */
    378. 

  378. function update_option( $option, $value, $autoload = null ) {
    379. 

  379. 	global $wpdb;
    380. 

  380. 

  381. 	$option = trim( $option );
    382. 

  382. 	if ( empty( $option ) ) {
    383. 

  383. 		return false;
    384. 

  384. 	}
    385. 

  385. 

  386. 	/*
    387. 

  387. 	 * Until a proper _deprecated_option() function can be introduced,
    388. 

  388. 	 * redirect requests to deprecated keys to the new, correct ones.
    389. 

  389. 	 */
    390. 

  390. 	$deprecated_keys = array(
    391. 

  391. 		'blacklist_keys'    => 'disallowed_keys',
    392. 

  392. 		'comment_whitelist' => 'comment_previously_approved',
    393. 

  393. 	);
    394. 

  394. 

  395. 	if ( ! wp_installing() && isset( $deprecated_keys[ $option ] ) ) {
    396. 

  396. 		_deprecated_argument(
    397. 

  397. 			__FUNCTION__,
    398. 

  398. 			'5.5.0',
    399. 

  399. 			sprintf(
    400. 

  400. 				/* translators: 1: Deprecated option key, 2: New option key. */
    401. 

  401. 				__( 'The "%1$s" option key has been renamed to "%2$s".' ),
    402. 

  402. 				$option,
    403. 

  403. 				$deprecated_keys[ $option ]
    404. 

  404. 			)
    405. 

  405. 		);
    406. 

  406. 		return update_option( $deprecated_keys[ $option ], $value, $autoload );
    407. 

  407. 	}
    408. 

  408. 

  409. 	wp_protect_special_option( $option );
    410. 

  410. 

  411. 	if ( is_object( $value ) ) {
    412. 

  412. 		$value = clone $value;
    413. 

  413. 	}
    414. 

  414. 

  415. 	$value     = sanitize_option( $option, $value );
    416. 

  416. 	$old_value = get_option( $option );
    417. 

  417. 

  418. 	/**
    419. 

  419. 	 * Filters a specific option before its value is (maybe) serialized and updated.
    420. 

  420. 	 *
    421. 

  421. 	 * The dynamic portion of the hook name, `$option`, refers to the option name.
    422. 

  422. 	 *
    423. 

  423. 	 * @since 2.6.0
    424. 

  424. 	 * @since 4.4.0 The `$option` parameter was added.
    425. 

  425. 	 *
    426. 

  426. 	 * @param mixed  $value     The new, unserialized option value.
    427. 

  427. 	 * @param mixed  $old_value The old option value.
    428. 

  428. 	 * @param string $option    Option name.
    429. 

  429. 	 */
    430. 

  430. 	$value = apply_filters( "pre_update_option_{$option}", $value, $old_value, $option );
    431. 

  431. 

  432. 	/**
    433. 

  433. 	 * Filters an option before its value is (maybe) serialized and updated.
    434. 

  434. 	 *
    435. 

  435. 	 * @since 3.9.0
    436. 

  436. 	 *
    437. 

  437. 	 * @param mixed  $value     The new, unserialized option value.
    438. 

  438. 	 * @param string $option    Name of the option.
    439. 

  439. 	 * @param mixed  $old_value The old option value.
    440. 

  440. 	 */
    441. 

  441. 	$value = apply_filters( 'pre_update_option', $value, $option, $old_value );
    442. 

  442. 

  443. 	/*
    444. 

  444. 	 * If the new and old values are the same, no need to update.
    445. 

  445. 	 *
    446. 

  446. 	 * Unserialized values will be adequate in most cases. If the unserialized
    447. 

  447. 	 * data differs, the (maybe) serialized data is checked to avoid
    448. 

  448. 	 * unnecessary database calls for otherwise identical object instances.
    449. 

  449. 	 *
    450. 

  450. 	 * See https://core.trac.wordpress.org/ticket/38903
    451. 

  451. 	 */
    452. 

  452. 	if ( $value === $old_value || maybe_serialize( $value ) === maybe_serialize( $old_value ) ) {
    453. 

  453. 		return false;
    454. 

  454. 	}
    455. 

  455. 

  456. 	/** This filter is documented in wp-includes/option.php */
    457. 

  457. 	if ( apply_filters( "default_option_{$option}", false, $option, false ) === $old_value ) {
    458. 

  458. 		// Default setting for new options is 'yes'.
    459. 

  459. 		if ( null === $autoload ) {
    460. 

  460. 			$autoload = 'yes';
    461. 

  461. 		}
    462. 

  462. 

  463. 		return add_option( $option, $value, '', $autoload );
    464. 

  464. 	}
    465. 

  465. 

  466. 	$serialized_value = maybe_serialize( $value );
    467. 

  467. 

  468. 	/**
    469. 

  469. 	 * Fires immediately before an option value is updated.
    470. 

  470. 	 *
    471. 

  471. 	 * @since 2.9.0
    472. 

  472. 	 *
    473. 

  473. 	 * @param string $option    Name of the option to update.
    474. 

  474. 	 * @param mixed  $old_value The old option value.
    475. 

  475. 	 * @param mixed  $value     The new option value.
    476. 

  476. 	 */
    477. 

  477. 	do_action( 'update_option', $option, $old_value, $value );
    478. 

  478. 

  479. 	$update_args = array(
    480. 

  480. 		'option_value' => $serialized_value,
    481. 

  481. 	);
    482. 

  482. 

  483. 	if ( null !== $autoload ) {
    484. 

  484. 		$update_args['autoload'] = ( 'no' === $autoload || false === $autoload ) ? 'no' : 'yes';
    485. 

  485. 	}
    486. 

  486. 

  487. 	$result = $wpdb->update( $wpdb->options, $update_args, array( 'option_name' => $option ) );
    488. 

  488. 	if ( ! $result ) {
    489. 

  489. 		return false;
    490. 

  490. 	}
    491. 

  491. 

  492. 	$notoptions = wp_cache_get( 'notoptions', 'options' );
    493. 

  493. 

  494. 	if ( is_array( $notoptions ) && isset( $notoptions[ $option ] ) ) {
    495. 

  495. 		unset( $notoptions[ $option ] );
    496. 

  496. 		wp_cache_set( 'notoptions', $notoptions, 'options' );
    497. 

  497. 	}
    498. 

  498. 

  499. 	if ( ! wp_installing() ) {
    500. 

  500. 		$alloptions = wp_load_alloptions( true );
    501. 

  501. 		if ( isset( $alloptions[ $option ] ) ) {
    502. 

  502. 			$alloptions[ $option ] = $serialized_value;
    503. 

  503. 			wp_cache_set( 'alloptions', $alloptions, 'options' );
    504. 

  504. 		} else {
    505. 

  505. 			wp_cache_set( $option, $serialized_value, 'options' );
    506. 

  506. 		}
    507. 

  507. 	}
    508. 

  508. 

  509. 	/**
    510. 

  510. 	 * Fires after the value of a specific option has been successfully updated.
    511. 

  511. 	 *
    512. 

  512. 	 * The dynamic portion of the hook name, `$option`, refers to the option name.
    513. 

  513. 	 *
    514. 

  514. 	 * @since 2.0.1
    515. 

  515. 	 * @since 4.4.0 The `$option` parameter was added.
    516. 

  516. 	 *
    517. 

  517. 	 * @param mixed  $old_value The old option value.
    518. 

  518. 	 * @param mixed  $value     The new option value.
    519. 

  519. 	 * @param string $option    Option name.
    520. 

  520. 	 */
    521. 

  521. 	do_action( "update_option_{$option}", $old_value, $value, $option );
    522. 

  522. 

  523. 	/**
    524. 

  524. 	 * Fires after the value of an option has been successfully updated.
    525. 

  525. 	 *
    526. 

  526. 	 * @since 2.9.0
    527. 

  527. 	 *
    528. 

  528. 	 * @param string $option    Name of the updated option.
    529. 

  529. 	 * @param mixed  $old_value The old option value.
    530. 

  530. 	 * @param mixed  $value     The new option value.
    531. 

  531. 	 */
    532. 

  532. 	do_action( 'updated_option', $option, $old_value, $value );
    533. 

  533. 

  534. 	return true;
    535. 

  535. }
    536. 

  536. 

  537. /**
    538. 

  538.  * Adds a new option.
    539. 

  539.  *
    540. 

  540.  * You do not need to serialize values. If the value needs to be serialized,
    541. 

  541.  * then it will be serialized before it is inserted into the database.
    542. 

  542.  * Remember, resources cannot be serialized or added as an option.
    543. 

  543.  *
    544. 

  544.  * You can create options without values and then update the values later.
    545. 

  545.  * Existing options will not be updated and checks are performed to ensure that you
    546. 

  546.  * aren't adding a protected WordPress option. Care should be taken to not name
    547. 

  547.  * options the same as the ones which are protected.
    548. 

  548.  *
    549. 

  549.  * @since 1.0.0
    550. 

  550.  *
    551. 

  551.  * @global wpdb $wpdb WordPress database abstraction object.
    552. 

  552.  *
    553. 

  553.  * @param string      $option     Name of the option to add. Expected to not be SQL-escaped.
    554. 

  554.  * @param mixed       $value      Optional. Option value. Must be serializable if non-scalar.
    555. 

  555.  *                                Expected to not be SQL-escaped.
    556. 

  556.  * @param string      $deprecated Optional. Description. Not used anymore.
    557. 

  557.  * @param string|bool $autoload   Optional. Whether to load the option when WordPress starts up.
    558. 

  558.  *                                Default is enabled. Accepts 'no' to disable for legacy reasons.
    559. 

  559.  * @return bool True if the option was added, false otherwise.
    560. 

  560.  */
    561. 

  561. function add_option( $option, $value = '', $deprecated = '', $autoload = 'yes' ) {
    562. 

  562. 	global $wpdb;
    563. 

  563. 

  564. 	if ( ! empty( $deprecated ) ) {
    565. 

  565. 		_deprecated_argument( __FUNCTION__, '2.3.0' );
    566. 

  566. 	}
    567. 

  567. 

  568. 	$option = trim( $option );
    569. 

  569. 	if ( empty( $option ) ) {
    570. 

  570. 		return false;
    571. 

  571. 	}
    572. 

  572. 

  573. 	/*
    574. 

  574. 	 * Until a proper _deprecated_option() function can be introduced,
    575. 

  575. 	 * redirect requests to deprecated keys to the new, correct ones.
    576. 

  576. 	 */
    577. 

  577. 	$deprecated_keys = array(
    578. 

  578. 		'blacklist_keys'    => 'disallowed_keys',
    579. 

  579. 		'comment_whitelist' => 'comment_previously_approved',
    580. 

  580. 	);
    581. 

  581. 

  582. 	if ( ! wp_installing() && isset( $deprecated_keys[ $option ] ) ) {
    583. 

  583. 		_deprecated_argument(
    584. 

  584. 			__FUNCTION__,
    585. 

  585. 			'5.5.0',
    586. 

  586. 			sprintf(
    587. 

  587. 				/* translators: 1: Deprecated option key, 2: New option key. */
    588. 

  588. 				__( 'The "%1$s" option key has been renamed to "%2$s".' ),
    589. 

  589. 				$option,
    590. 

  590. 				$deprecated_keys[ $option ]
    591. 

  591. 			)
    592. 

  592. 		);
    593. 

  593. 		return add_option( $deprecated_keys[ $option ], $value, $deprecated, $autoload );
    594. 

  594. 	}
    595. 

  595. 

  596. 	wp_protect_special_option( $option );
    597. 

  597. 

  598. 	if ( is_object( $value ) ) {
    599. 

  599. 		$value = clone $value;
    600. 

  600. 	}
    601. 

  601. 

  602. 	$value = sanitize_option( $option, $value );
    603. 

  603. 

  604. 	// Make sure the option doesn't already exist.
    605. 

  605. 	// We can check the 'notoptions' cache before we ask for a DB query.
    606. 

  606. 	$notoptions = wp_cache_get( 'notoptions', 'options' );
    607. 

  607. 

  608. 	if ( ! is_array( $notoptions ) || ! isset( $notoptions[ $option ] ) ) {
    609. 

  609. 		/** This filter is documented in wp-includes/option.php */
    610. 

  610. 		if ( apply_filters( "default_option_{$option}", false, $option, false ) !== get_option( $option ) ) {
    611. 

  611. 			return false;
    612. 

  612. 		}
    613. 

  613. 	}
    614. 

  614. 

  615. 	$serialized_value = maybe_serialize( $value );
    616. 

  616. 	$autoload         = ( 'no' === $autoload || false === $autoload ) ? 'no' : 'yes';
    617. 

  617. 

  618. 	/**
    619. 

  619. 	 * Fires before an option is added.
    620. 

  620. 	 *
    621. 

  621. 	 * @since 2.9.0
    622. 

  622. 	 *
    623. 

  623. 	 * @param string $option Name of the option to add.
    624. 

  624. 	 * @param mixed  $value  Value of the option.
    625. 

  625. 	 */
    626. 

  626. 	do_action( 'add_option', $option, $value );
    627. 

  627. 

  628. 	$result = $wpdb->query( $wpdb->prepare( "INSERT INTO `$wpdb->options` (`option_name`, `option_value`, `autoload`) VALUES (%s, %s, %s) ON DUPLICATE KEY UPDATE `option_name` = VALUES(`option_name`), `option_value` = VALUES(`option_value`), `autoload` = VALUES(`autoload`)", $option, $serialized_value, $autoload ) );
    629. 

  629. 	if ( ! $result ) {
    630. 

  630. 		return false;
    631. 

  631. 	}
    632. 

  632. 

  633. 	if ( ! wp_installing() ) {
    634. 

  634. 		if ( 'yes' === $autoload ) {
    635. 

  635. 			$alloptions            = wp_load_alloptions( true );
    636. 

  636. 			$alloptions[ $option ] = $serialized_value;
    637. 

  637. 			wp_cache_set( 'alloptions', $alloptions, 'options' );
    638. 

  638. 		} else {
    639. 

  639. 			wp_cache_set( $option, $serialized_value, 'options' );
    640. 

  640. 		}
    641. 

  641. 	}
    642. 

  642. 

  643. 	// This option exists now.
    644. 

  644. 	$notoptions = wp_cache_get( 'notoptions', 'options' ); // Yes, again... we need it to be fresh.
    645. 

  645. 

  646. 	if ( is_array( $notoptions ) && isset( $notoptions[ $option ] ) ) {
    647. 

  647. 		unset( $notoptions[ $option ] );
    648. 

  648. 		wp_cache_set( 'notoptions', $notoptions, 'options' );
    649. 

  649. 	}
    650. 

  650. 

  651. 	/**
    652. 

  652. 	 * Fires after a specific option has been added.
    653. 

  653. 	 *
    654. 

  654. 	 * The dynamic portion of the hook name, `$option`, refers to the option name.
    655. 

  655. 	 *
    656. 

  656. 	 * @since 2.5.0 As "add_option_{$name}"
    657. 

  657. 	 * @since 3.0.0
    658. 

  658. 	 *
    659. 

  659. 	 * @param string $option Name of the option to add.
    660. 

  660. 	 * @param mixed  $value  Value of the option.
    661. 

  661. 	 */
    662. 

  662. 	do_action( "add_option_{$option}", $option, $value );
    663. 

  663. 

  664. 	/**
    665. 

  665. 	 * Fires after an option has been added.
    666. 

  666. 	 *
    667. 

  667. 	 * @since 2.9.0
    668. 

  668. 	 *
    669. 

  669. 	 * @param string $option Name of the added option.
    670. 

  670. 	 * @param mixed  $value  Value of the option.
    671. 

  671. 	 */
    672. 

  672. 	do_action( 'added_option', $option, $value );
    673. 

  673. 

  674. 	return true;
    675. 

  675. }
    676. 

  676. 

  677. /**
    678. 

  678.  * Removes option by name. Prevents removal of protected WordPress options.
    679. 

  679.  *
    680. 

  680.  * @since 1.2.0
    681. 

  681.  *
    682. 

  682.  * @global wpdb $wpdb WordPress database abstraction object.
    683. 

  683.  *
    684. 

  684.  * @param string $option Name of the option to delete. Expected to not be SQL-escaped.
    685. 

  685.  * @return bool True if the option was deleted, false otherwise.
    686. 

  686.  */
    687. 

  687. function delete_option( $option ) {
    688. 

  688. 	global $wpdb;
    689. 

  689. 

  690. 	$option = trim( $option );
    691. 

  691. 	if ( empty( $option ) ) {
    692. 

  692. 		return false;
    693. 

  693. 	}
    694. 

  694. 

  695. 	wp_protect_special_option( $option );
    696. 

  696. 

  697. 	// Get the ID, if no ID then return.
    698. 

  698. 	$row = $wpdb->get_row( $wpdb->prepare( "SELECT autoload FROM $wpdb->options WHERE option_name = %s", $option ) );
    699. 

  699. 	if ( is_null( $row ) ) {
    700. 

  700. 		return false;
    701. 

  701. 	}
    702. 

  702. 

  703. 	/**
    704. 

  704. 	 * Fires immediately before an option is deleted.
    705. 

  705. 	 *
    706. 

  706. 	 * @since 2.9.0
    707. 

  707. 	 *
    708. 

  708. 	 * @param string $option Name of the option to delete.
    709. 

  709. 	 */
    710. 

  710. 	do_action( 'delete_option', $option );
    711. 

  711. 

  712. 	$result = $wpdb->delete( $wpdb->options, array( 'option_name' => $option ) );
    713. 

  713. 

  714. 	if ( ! wp_installing() ) {
    715. 

  715. 		if ( 'yes' === $row->autoload ) {
    716. 

  716. 			$alloptions = wp_load_alloptions( true );
    717. 

  717. 			if ( is_array( $alloptions ) && isset( $alloptions[ $option ] ) ) {
    718. 

  718. 				unset( $alloptions[ $option ] );
    719. 

  719. 				wp_cache_set( 'alloptions', $alloptions, 'options' );
    720. 

  720. 			}
    721. 

  721. 		} else {
    722. 

  722. 			wp_cache_delete( $option, 'options' );
    723. 

  723. 		}
    724. 

  724. 	}
    725. 

  725. 

  726. 	if ( $result ) {
    727. 

  727. 

  728. 		/**
    729. 

  729. 		 * Fires after a specific option has been deleted.
    730. 

  730. 		 *
    731. 

  731. 		 * The dynamic portion of the hook name, `$option`, refers to the option name.
    732. 

  732. 		 *
    733. 

  733. 		 * @since 3.0.0
    734. 

  734. 		 *
    735. 

  735. 		 * @param string $option Name of the deleted option.
    736. 

  736. 		 */
    737. 

  737. 		do_action( "delete_option_{$option}", $option );
    738. 

  738. 

  739. 		/**
    740. 

  740. 		 * Fires after an option has been deleted.
    741. 

  741. 		 *
    742. 

  742. 		 * @since 2.9.0
    743. 

  743. 		 *
    744. 

  744. 		 * @param string $option Name of the deleted option.
    745. 

  745. 		 */
    746. 

  746. 		do_action( 'deleted_option', $option );
    747. 

  747. 

  748. 		return true;
    749. 

  749. 	}
    750. 

  750. 

  751. 	return false;
    752. 

  752. }
    753. 

  753. 

  754. /**
    755. 

  755.  * Deletes a transient.
    756. 

  756.  *
    757. 

  757.  * @since 2.8.0
    758. 

  758.  *
    759. 

  759.  * @param string $transient Transient name. Expected to not be SQL-escaped.
    760. 

  760.  * @return bool True if the transient was deleted, false otherwise.
    761. 

  761.  */
    762. 

  762. function delete_transient( $transient ) {
    763. 

  763. 

  764. 	/**
    765. 

  765. 	 * Fires immediately before a specific transient is deleted.
    766. 

  766. 	 *
    767. 

  767. 	 * The dynamic portion of the hook name, `$transient`, refers to the transient name.
    768. 

  768. 	 *
    769. 

  769. 	 * @since 3.0.0
    770. 

  770. 	 *
    771. 

  771. 	 * @param string $transient Transient name.
    772. 

  772. 	 */
    773. 

  773. 	do_action( "delete_transient_{$transient}", $transient );
    774. 

  774. 

  775. 	if ( wp_using_ext_object_cache() ) {
    776. 

  776. 		$result = wp_cache_delete( $transient, 'transient' );
    777. 

  777. 	} else {
    778. 

  778. 		$option_timeout = '_transient_timeout_' . $transient;
    779. 

  779. 		$option         = '_transient_' . $transient;
    780. 

  780. 		$result         = delete_option( $option );
    781. 

  781. 

  782. 		if ( $result ) {
    783. 

  783. 			delete_option( $option_timeout );
    784. 

  784. 		}
    785. 

  785. 	}
    786. 

  786. 

  787. 	if ( $result ) {
    788. 

  788. 

  789. 		/**
    790. 

  790. 		 * Fires after a transient is deleted.
    791. 

  791. 		 *
    792. 

  792. 		 * @since 3.0.0
    793. 

  793. 		 *
    794. 

  794. 		 * @param string $transient Deleted transient name.
    795. 

  795. 		 */
    796. 

  796. 		do_action( 'deleted_transient', $transient );
    797. 

  797. 	}
    798. 

  798. 

  799. 	return $result;
    800. 

  800. }
    801. 

  801. 

  802. /**
    803. 

  803.  * Retrieves the value of a transient.
    804. 

  804.  *
    805. 

  805.  * If the transient does not exist, does not have a value, or has expired,
    806. 

  806.  * then the return value will be false.
    807. 

  807.  *
    808. 

  808.  * @since 2.8.0
    809. 

  809.  *
    810. 

  810.  * @param string $transient Transient name. Expected to not be SQL-escaped.
    811. 

  811.  * @return mixed Value of transient.
    812. 

  812.  */
    813. 

  813. function get_transient( $transient ) {
    814. 

  814. 

  815. 	/**
    816. 

  816. 	 * Filters the value of an existing transient before it is retrieved.
    817. 

  817. 	 *
    818. 

  818. 	 * The dynamic portion of the hook name, `$transient`, refers to the transient name.
    819. 

  819. 	 *
    820. 

  820. 	 * Returning a truthy value from the filter will effectively short-circuit retrieval
    821. 

  821. 	 * and return the passed value instead.
    822. 

  822. 	 *
    823. 

  823. 	 * @since 2.8.0
    824. 

  824. 	 * @since 4.4.0 The `$transient` parameter was added
    825. 

  825. 	 *
    826. 

  826. 	 * @param mixed  $pre_transient The default value to return if the transient does not exist.
    827. 

  827. 	 *                              Any value other than false will short-circuit the retrieval
    828. 

  828. 	 *                              of the transient, and return that value.
    829. 

  829. 	 * @param string $transient     Transient name.
    830. 

  830. 	 */
    831. 

  831. 	$pre = apply_filters( "pre_transient_{$transient}", false, $transient );
    832. 

  832. 

  833. 	if ( false !== $pre ) {
    834. 

  834. 		return $pre;
    835. 

  835. 	}
    836. 

  836. 

  837. 	if ( wp_using_ext_object_cache() ) {
    838. 

  838. 		$value = wp_cache_get( $transient, 'transient' );
    839. 

  839. 	} else {
    840. 

  840. 		$transient_option = '_transient_' . $transient;
    841. 

  841. 		if ( ! wp_installing() ) {
    842. 

  842. 			// If option is not in alloptions, it is not autoloaded and thus has a timeout.
    843. 

  843. 			$alloptions = wp_load_alloptions();
    844. 

  844. 			if ( ! isset( $alloptions[ $transient_option ] ) ) {
    845. 

  845. 				$transient_timeout = '_transient_timeout_' . $transient;
    846. 

  846. 				$timeout           = get_option( $transient_timeout );
    847. 

  847. 				if ( false !== $timeout && $timeout < time() ) {
    848. 

  848. 					delete_option( $transient_option );
    849. 

  849. 					delete_option( $transient_timeout );
    850. 

  850. 					$value = false;
    851. 

  851. 				}
    852. 

  852. 			}
    853. 

  853. 		}
    854. 

  854. 

  855. 		if ( ! isset( $value ) ) {
    856. 

  856. 			$value = get_option( $transient_option );
    857. 

  857. 		}
    858. 

  858. 	}
    859. 

  859. 

  860. 	/**
    861. 

  861. 	 * Filters an existing transient's value.
    862. 

  862. 	 *
    863. 

  863. 	 * The dynamic portion of the hook name, `$transient`, refers to the transient name.
    864. 

  864. 	 *
    865. 

  865. 	 * @since 2.8.0
    866. 

  866. 	 * @since 4.4.0 The `$transient` parameter was added
    867. 

  867. 	 *
    868. 

  868. 	 * @param mixed  $value     Value of transient.
    869. 

  869. 	 * @param string $transient Transient name.
    870. 

  870. 	 */
    871. 

  871. 	return apply_filters( "transient_{$transient}", $value, $transient );
    872. 

  872. }
    873. 

  873. 

  874. /**
    875. 

  875.  * Sets/updates the value of a transient.
    876. 

  876.  *
    877. 

  877.  * You do not need to serialize values. If the value needs to be serialized,
    878. 

  878.  * then it will be serialized before it is set.
    879. 

  879.  *
    880. 

  880.  * @since 2.8.0
    881. 

  881.  *
    882. 

  882.  * @param string $transient  Transient name. Expected to not be SQL-escaped.
    883. 

  883.  *                           Must be 172 characters or fewer in length.
    884. 

  884.  * @param mixed  $value      Transient value. Must be serializable if non-scalar.
    885. 

  885.  *                           Expected to not be SQL-escaped.
    886. 

  886.  * @param int    $expiration Optional. Time until expiration in seconds. Default 0 (no expiration).
    887. 

  887.  * @return bool True if the value was set, false otherwise.
    888. 

  888.  */
    889. 

  889. function set_transient( $transient, $value, $expiration = 0 ) {
    890. 

  890. 

  891. 	$expiration = (int) $expiration;
    892. 

  892. 

  893. 	/**
    894. 

  894. 	 * Filters a specific transient before its value is set.
    895. 

  895. 	 *
    896. 

  896. 	 * The dynamic portion of the hook name, `$transient`, refers to the transient name.
    897. 

  897. 	 *
    898. 

  898. 	 * @since 3.0.0
    899. 

  899. 	 * @since 4.2.0 The `$expiration` parameter was added.
    900. 

  900. 	 * @since 4.4.0 The `$transient` parameter was added.
    901. 

  901. 	 *
    902. 

  902. 	 * @param mixed  $value      New value of transient.
    903. 

  903. 	 * @param int    $expiration Time until expiration in seconds.
    904. 

  904. 	 * @param string $transient  Transient name.
    905. 

  905. 	 */
    906. 

  906. 	$value = apply_filters( "pre_set_transient_{$transient}", $value, $expiration, $transient );
    907. 

  907. 

  908. 	/**
    909. 

  909. 	 * Filters the expiration for a transient before its value is set.
    910. 

  910. 	 *
    911. 

  911. 	 * The dynamic portion of the hook name, `$transient`, refers to the transient name.
    912. 

  912. 	 *
    913. 

  913. 	 * @since 4.4.0
    914. 

  914. 	 *
    915. 

  915. 	 * @param int    $expiration Time until expiration in seconds. Use 0 for no expiration.
    916. 

  916. 	 * @param mixed  $value      New value of transient.
    917. 

  917. 	 * @param string $transient  Transient name.
    918. 

  918. 	 */
    919. 

  919. 	$expiration = apply_filters( "expiration_of_transient_{$transient}", $expiration, $value, $transient );
    920. 

  920. 

  921. 	if ( wp_using_ext_object_cache() ) {
    922. 

  922. 		$result = wp_cache_set( $transient, $value, 'transient', $expiration );
    923. 

  923. 	} else {
    924. 

  924. 		$transient_timeout = '_transient_timeout_' . $transient;
    925. 

  925. 		$transient_option  = '_transient_' . $transient;
    926. 

  926. 

  927. 		if ( false === get_option( $transient_option ) ) {
    928. 

  928. 			$autoload = 'yes';
    929. 

  929. 			if ( $expiration ) {
    930. 

  930. 				$autoload = 'no';
    931. 

  931. 				add_option( $transient_timeout, time() + $expiration, '', 'no' );
    932. 

  932. 			}
    933. 

  933. 			$result = add_option( $transient_option, $value, '', $autoload );
    934. 

  934. 		} else {
    935. 

  935. 			// If expiration is requested, but the transient has no timeout option,
    936. 

  936. 			// delete, then re-create transient rather than update.
    937. 

  937. 			$update = true;
    938. 

  938. 

  939. 			if ( $expiration ) {
    940. 

  940. 				if ( false === get_option( $transient_timeout ) ) {
    941. 

  941. 					delete_option( $transient_option );
    942. 

  942. 					add_option( $transient_timeout, time() + $expiration, '', 'no' );
    943. 

  943. 					$result = add_option( $transient_option, $value, '', 'no' );
    944. 

  944. 					$update = false;
    945. 

  945. 				} else {
    946. 

  946. 					update_option( $transient_timeout, time() + $expiration );
    947. 

  947. 				}
    948. 

  948. 			}
    949. 

  949. 

  950. 			if ( $update ) {
    951. 

  951. 				$result = update_option( $transient_option, $value );
    952. 

  952. 			}
    953. 

  953. 		}
    954. 

  954. 	}
    955. 

  955. 

  956. 	if ( $result ) {
    957. 

  957. 

  958. 		/**
    959. 

  959. 		 * Fires after the value for a specific transient has been set.
    960. 

  960. 		 *
    961. 

  961. 		 * The dynamic portion of the hook name, `$transient`, refers to the transient name.
    962. 

  962. 		 *
    963. 

  963. 		 * @since 3.0.0
    964. 

  964. 		 * @since 3.6.0 The `$value` and `$expiration` parameters were added.
    965. 

  965. 		 * @since 4.4.0 The `$transient` parameter was added.
    966. 

  966. 		 *
    967. 

  967. 		 * @param mixed  $value      Transient value.
    968. 

  968. 		 * @param int    $expiration Time until expiration in seconds.
    969. 

  969. 		 * @param string $transient  The name of the transient.
    970. 

  970. 		 */
    971. 

  971. 		do_action( "set_transient_{$transient}", $value, $expiration, $transient );
    972. 

  972. 

  973. 		/**
    974. 

  974. 		 * Fires after the value for a transient has been set.
    975. 

  975. 		 *
    976. 

  976. 		 * @since 3.0.0
    977. 

  977. 		 * @since 3.6.0 The `$value` and `$expiration` parameters were added.
    978. 

  978. 		 *
    979. 

  979. 		 * @param string $transient  The name of the transient.
    980. 

  980. 		 * @param mixed  $value      Transient value.
    981. 

  981. 		 * @param int    $expiration Time until expiration in seconds.
    982. 

  982. 		 */
    983. 

  983. 		do_action( 'setted_transient', $transient, $value, $expiration );
    984. 

  984. 	}
    985. 

  985. 

  986. 	return $result;
    987. 

  987. }
    988. 

  988. 

  989. /**
    990. 

  990.  * Deletes all expired transients.
    991. 

  991.  *
    992. 

  992.  * The multi-table delete syntax is used to delete the transient record
    993. 

  993.  * from table a, and the corresponding transient_timeout record from table b.
    994. 

  994.  *
    995. 

  995.  * @since 4.9.0
    996. 

  996.  *
    997. 

  997.  * @param bool $force_db Optional. Force cleanup to run against the database even when an external object cache is used.
    998. 

  998.  */
    999. 

  999. function delete_expired_transients( $force_db = false ) {
    1000. 

  1000. 	global $wpdb;
    1001. 

  1001. 

  1002. 	if ( ! $force_db && wp_using_ext_object_cache() ) {
    1003. 

  1003. 		return;
    1004. 

  1004. 	}
    1005. 

  1005. 

  1006. 	$wpdb->query(
    1007. 

  1007. 		$wpdb->prepare(
    1008. 

  1008. 			"DELETE a, b FROM {$wpdb->options} a, {$wpdb->options} b
    1009. 

  1009. 			WHERE a.option_name LIKE %s
    1010. 

  1010. 			AND a.option_name NOT LIKE %s
    1011. 

  1011. 			AND b.option_name = CONCAT( '_transient_timeout_', SUBSTRING( a.option_name, 12 ) )
    1012. 

  1012. 			AND b.option_value < %d",
    1013. 

  1013. 			$wpdb->esc_like( '_transient_' ) . '%',
    1014. 

  1014. 			$wpdb->esc_like( '_transient_timeout_' ) . '%',
    1015. 

  1015. 			time()
    1016. 

  1016. 		)
    1017. 

  1017. 	);
    1018. 

  1018. 

  1019. 	if ( ! is_multisite() ) {
    1020. 

  1020. 		// Single site stores site transients in the options table.
    1021. 

  1021. 		$wpdb->query(
    1022. 

  1022. 			$wpdb->prepare(
    1023. 

  1023. 				"DELETE a, b FROM {$wpdb->options} a, {$wpdb->options} b
    1024. 

  1024. 				WHERE a.option_name LIKE %s
    1025. 

  1025. 				AND a.option_name NOT LIKE %s
    1026. 

  1026. 				AND b.option_name = CONCAT( '_site_transient_timeout_', SUBSTRING( a.option_name, 17 ) )
    1027. 

  1027. 				AND b.option_value < %d",
    1028. 

  1028. 				$wpdb->esc_like( '_site_transient_' ) . '%',
    1029. 

  1029. 				$wpdb->esc_like( '_site_transient_timeout_' ) . '%',
    1030. 

  1030. 				time()
    1031. 

  1031. 			)
    1032. 

  1032. 		);
    1033. 

  1033. 	} elseif ( is_multisite() && is_main_site() && is_main_network() ) {
    1034. 

  1034. 		// Multisite stores site transients in the sitemeta table.
    1035. 

  1035. 		$wpdb->query(
    1036. 

  1036. 			$wpdb->prepare(
    1037. 

  1037. 				"DELETE a, b FROM {$wpdb->sitemeta} a, {$wpdb->sitemeta} b
    1038. 

  1038. 				WHERE a.meta_key LIKE %s
    1039. 

  1039. 				AND a.meta_key NOT LIKE %s
    1040. 

  1040. 				AND b.meta_key = CONCAT( '_site_transient_timeout_', SUBSTRING( a.meta_key, 17 ) )
    1041. 

  1041. 				AND b.meta_value < %d",
    1042. 

  1042. 				$wpdb->esc_like( '_site_transient_' ) . '%',
    1043. 

  1043. 				$wpdb->esc_like( '_site_transient_timeout_' ) . '%',
    1044. 

  1044. 				time()
    1045. 

  1045. 			)
    1046. 

  1046. 		);
    1047. 

  1047. 	}
    1048. 

  1048. }
    1049. 

  1049. 

  1050. /**
    1051. 

  1051.  * Saves and restores user interface settings stored in a cookie.
    1052. 

  1052.  *
    1053. 

  1053.  * Checks if the current user-settings cookie is updated and stores it. When no
    1054. 

  1054.  * cookie exists (different browser used), adds the last saved cookie restoring
    1055. 

  1055.  * the settings.
    1056. 

  1056.  *
    1057. 

  1057.  * @since 2.7.0
    1058. 

  1058.  */
    1059. 

  1059. function wp_user_settings() {
    1060. 

  1060. 

  1061. 	if ( ! is_admin() || wp_doing_ajax() ) {
    1062. 

  1062. 		return;
    1063. 

  1063. 	}
    1064. 

  1064. 

  1065. 	$user_id = get_current_user_id();
    1066. 

  1066. 	if ( ! $user_id ) {
    1067. 

  1067. 		return;
    1068. 

  1068. 	}
    1069. 

  1069. 

  1070. 	if ( ! is_user_member_of_blog() ) {
    1071. 

  1071. 		return;
    1072. 

  1072. 	}
    1073. 

  1073. 

  1074. 	$settings = (string) get_user_option( 'user-settings', $user_id );
    1075. 

  1075. 

  1076. 	if ( isset( $_COOKIE[ 'wp-settings-' . $user_id ] ) ) {
    1077. 

  1077. 		$cookie = preg_replace( '/[^A-Za-z0-9=&_]/', '', $_COOKIE[ 'wp-settings-' . $user_id ] );
    1078. 

  1078. 

  1079. 		// No change or both empty.
    1080. 

  1080. 		if ( $cookie == $settings ) {
    1081. 

  1081. 			return;
    1082. 

  1082. 		}
    1083. 

  1083. 

  1084. 		$last_saved = (int) get_user_option( 'user-settings-time', $user_id );
    1085. 

  1085. 		$current    = isset( $_COOKIE[ 'wp-settings-time-' . $user_id ] ) ? preg_replace( '/[^0-9]/', '', $_COOKIE[ 'wp-settings-time-' . $user_id ] ) : 0;
    1086. 

  1086. 

  1087. 		// The cookie is newer than the saved value. Update the user_option and leave the cookie as-is.
    1088. 

  1088. 		if ( $current > $last_saved ) {
    1089. 

  1089. 			update_user_option( $user_id, 'user-settings', $cookie, false );
    1090. 

  1090. 			update_user_option( $user_id, 'user-settings-time', time() - 5, false );
    1091. 

  1091. 			return;
    1092. 

  1092. 		}
    1093. 

  1093. 	}
    1094. 

  1094. 

  1095. 	// The cookie is not set in the current browser or the saved value is newer.
    1096. 

  1096. 	$secure = ( 'https' === parse_url( admin_url(), PHP_URL_SCHEME ) );
    1097. 

  1097. 	setcookie( 'wp-settings-' . $user_id, $settings, time() + YEAR_IN_SECONDS, SITECOOKIEPATH, null, $secure );
    1098. 

  1098. 	setcookie( 'wp-settings-time-' . $user_id, time(), time() + YEAR_IN_SECONDS, SITECOOKIEPATH, null, $secure );
    1099. 

  1099. 	$_COOKIE[ 'wp-settings-' . $user_id ] = $settings;
    1100. 

  1100. }
    1101. 

  1101. 

  1102. /**
    1103. 

  1103.  * Retrieves user interface setting value based on setting name.
    1104. 

  1104.  *
    1105. 

  1105.  * @since 2.7.0
    1106. 

  1106.  *
    1107. 

  1107.  * @param string       $name    The name of the setting.
    1108. 

  1108.  * @param string|false $default Optional. Default value to return when $name is not set. Default false.
    1109. 

  1109.  * @return mixed The last saved user setting or the default value/false if it doesn't exist.
    1110. 

  1110.  */
    1111. 

  1111. function get_user_setting( $name, $default = false ) {
    1112. 

  1112. 	$all_user_settings = get_all_user_settings();
    1113. 

  1113. 

  1114. 	return isset( $all_user_settings[ $name ] ) ? $all_user_settings[ $name ] : $default;
    1115. 

  1115. }
    1116. 

  1116. 

  1117. /**
    1118. 

  1118.  * Adds or updates user interface setting.
    1119. 

  1119.  *
    1120. 

  1120.  * Both $name and $value can contain only ASCII letters, numbers, hyphens, and underscores.
    1121. 

  1121.  *
    1122. 

  1122.  * This function has to be used before any output has started as it calls setcookie().
    1123. 

  1123.  *
    1124. 

  1124.  * @since 2.8.0
    1125. 

  1125.  *
    1126. 

  1126.  * @param string $name  The name of the setting.
    1127. 

  1127.  * @param string $value The value for the setting.
    1128. 

  1128.  * @return bool|null True if set successfully, false otherwise.
    1129. 

  1129.  *                   Null if the current user is not a member of the site.
    1130. 

  1130.  */
    1131. 

  1131. function set_user_setting( $name, $value ) {
    1132. 

  1132. 	if ( headers_sent() ) {
    1133. 

  1133. 		return false;
    1134. 

  1134. 	}
    1135. 

  1135. 

  1136. 	$all_user_settings          = get_all_user_settings();
    1137. 

  1137. 	$all_user_settings[ $name ] = $value;
    1138. 

  1138. 

  1139. 	return wp_set_all_user_settings( $all_user_settings );
    1140. 

  1140. }
    1141. 

  1141. 

  1142. /**
    1143. 

  1143.  * Deletes user interface settings.
    1144. 

  1144.  *
    1145. 

  1145.  * Deleting settings would reset them to the defaults.
    1146. 

  1146.  *
    1147. 

  1147.  * This function has to be used before any output has started as it calls setcookie().
    1148. 

  1148.  *
    1149. 

  1149.  * @since 2.7.0
    1150. 

  1150.  *
    1151. 

  1151.  * @param string $names The name or array of names of the setting to be deleted.
    1152. 

  1152.  * @return bool|null True if deleted successfully, false otherwise.
    1153. 

  1153.  *                   Null if the current user is not a member of the site.
    1154. 

  1154.  */
    1155. 

  1155. function delete_user_setting( $names ) {
    1156. 

  1156. 	if ( headers_sent() ) {
    1157. 

  1157. 		return false;
    1158. 

  1158. 	}
    1159. 

  1159. 

  1160. 	$all_user_settings = get_all_user_settings();
    1161. 

  1161. 	$names             = (array) $names;
    1162. 

  1162. 	$deleted           = false;
    1163. 

  1163. 

  1164. 	foreach ( $names as $name ) {
    1165. 

  1165. 		if ( isset( $all_user_settings[ $name ] ) ) {
    1166. 

  1166. 			unset( $all_user_settings[ $name ] );
    1167. 

  1167. 			$deleted = true;
    1168. 

  1168. 		}
    1169. 

  1169. 	}
    1170. 

  1170. 

  1171. 	if ( $deleted ) {
    1172. 

  1172. 		return wp_set_all_user_settings( $all_user_settings );
    1173. 

  1173. 	}
    1174. 

  1174. 

  1175. 	return false;
    1176. 

  1176. }
    1177. 

  1177. 

  1178. /**
    1179. 

  1179.  * Retrieves all user interface settings.
    1180. 

  1180.  *
    1181. 

  1181.  * @since 2.7.0
    1182. 

  1182.  *
    1183. 

  1183.  * @global array $_updated_user_settings
    1184. 

  1184.  *
    1185. 

  1185.  * @return array The last saved user settings or empty array.
    1186. 

  1186.  */
    1187. 

  1187. function get_all_user_settings() {
    1188. 

  1188. 	global $_updated_user_settings;
    1189. 

  1189. 

  1190. 	$user_id = get_current_user_id();
    1191. 

  1191. 	if ( ! $user_id ) {
    1192. 

  1192. 		return array();
    1193. 

  1193. 	}
    1194. 

  1194. 

  1195. 	if ( isset( $_updated_user_settings ) && is_array( $_updated_user_settings ) ) {
    1196. 

  1196. 		return $_updated_user_settings;
    1197. 

  1197. 	}
    1198. 

  1198. 

  1199. 	$user_settings = array();
    1200. 

  1200. 

  1201. 	if ( isset( $_COOKIE[ 'wp-settings-' . $user_id ] ) ) {
    1202. 

  1202. 		$cookie = preg_replace( '/[^A-Za-z0-9=&_-]/', '', $_COOKIE[ 'wp-settings-' . $user_id ] );
    1203. 

  1203. 

  1204. 		if ( strpos( $cookie, '=' ) ) { // '=' cannot be 1st char.
    1205. 

  1205. 			parse_str( $cookie, $user_settings );
    1206. 

  1206. 		}
    1207. 

  1207. 	} else {
    1208. 

  1208. 		$option = get_user_option( 'user-settings', $user_id );
    1209. 

  1209. 

  1210. 		if ( $option && is_string( $option ) ) {
    1211. 

  1211. 			parse_str( $option, $user_settings );
    1212. 

  1212. 		}
    1213. 

  1213. 	}
    1214. 

  1214. 

  1215. 	$_updated_user_settings = $user_settings;
    1216. 

  1216. 	return $user_settings;
    1217. 

  1217. }
    1218. 

  1218. 

  1219. /**
    1220. 

  1220.  * Private. Sets all user interface settings.
    1221. 

  1221.  *
    1222. 

  1222.  * @since 2.8.0
    1223. 

  1223.  * @access private
    1224. 

  1224.  *
    1225. 

  1225.  * @global array $_updated_user_settings
    1226. 

  1226.  *
    1227. 

  1227.  * @param array $user_settings User settings.
    1228. 

  1228.  * @return bool|null True if set successfully, false if the current user could not be found.
    1229. 

  1229.  *                   Null if the current user is not a member of the site.
    1230. 

  1230.  */
    1231. 

  1231. function wp_set_all_user_settings( $user_settings ) {
    1232. 

  1232. 	global $_updated_user_settings;
    1233. 

  1233. 

  1234. 	$user_id = get_current_user_id();
    1235. 

  1235. 	if ( ! $user_id ) {
    1236. 

  1236. 		return false;
    1237. 

  1237. 	}
    1238. 

  1238. 

  1239. 	if ( ! is_user_member_of_blog() ) {
    1240. 

  1240. 		return;
    1241. 

  1241. 	}
    1242. 

  1242. 

  1243. 	$settings = '';
    1244. 

  1244. 	foreach ( $user_settings as $name => $value ) {
    1245. 

  1245. 		$_name  = preg_replace( '/[^A-Za-z0-9_-]+/', '', $name );
    1246. 

  1246. 		$_value = preg_replace( '/[^A-Za-z0-9_-]+/', '', $value );
    1247. 

  1247. 

  1248. 		if ( ! empty( $_name ) ) {
    1249. 

  1249. 			$settings .= $_name . '=' . $_value . '&';
    1250. 

  1250. 		}
    1251. 

  1251. 	}
    1252. 

  1252. 

  1253. 	$settings = rtrim( $settings, '&' );
    1254. 

  1254. 	parse_str( $settings, $_updated_user_settings );
    1255. 

  1255. 

  1256. 	update_user_option( $user_id, 'user-settings', $settings, false );
    1257. 

  1257. 	update_user_option( $user_id, 'user-settings-time', time(), false );
    1258. 

  1258. 

  1259. 	return true;
    1260. 

  1260. }
    1261. 

  1261. 

  1262. /**
    1263. 

  1263.  * Deletes the user settings of the current user.
    1264. 

  1264.  *
    1265. 

  1265.  * @since 2.7.0
    1266. 

  1266.  */
    1267. 

  1267. function delete_all_user_settings() {
    1268. 

  1268. 	$user_id = get_current_user_id();
    1269. 

  1269. 	if ( ! $user_id ) {
    1270. 

  1270. 		return;
    1271. 

  1271. 	}
    1272. 

  1272. 

  1273. 	update_user_option( $user_id, 'user-settings', '', false );
    1274. 

  1274. 	setcookie( 'wp-settings-' . $user_id, ' ', time() - YEAR_IN_SECONDS, SITECOOKIEPATH );
    1275. 

  1275. }
    1276. 

  1276. 

  1277. /**
    1278. 

  1278.  * Retrieve an option value for the current network based on name of option.
    1279. 

  1279.  *
    1280. 

  1280.  * @since 2.8.0
    1281. 

  1281.  * @since 4.4.0 The `$use_cache` parameter was deprecated.
    1282. 

  1282.  * @since 4.4.0 Modified into wrapper for get_network_option()
    1283. 

  1283.  *
    1284. 

  1284.  * @see get_network_option()
    1285. 

  1285.  *
    1286. 

  1286.  * @param string $option     Name of the option to retrieve. Expected to not be SQL-escaped.
    1287. 

  1287.  * @param mixed  $default    Optional. Value to return if the option doesn't exist. Default false.
    1288. 

  1288.  * @param bool   $deprecated Whether to use cache. Multisite only. Always set to true.
    1289. 

  1289.  * @return mixed Value set for the option.
    1290. 

  1290.  */
    1291. 

  1291. function get_site_option( $option, $default = false, $deprecated = true ) {
    1292. 

  1292. 	return get_network_option( null, $option, $default );
    1293. 

  1293. }
    1294. 

  1294. 

  1295. /**
    1296. 

  1296.  * Adds a new option for the current network.
    1297. 

  1297.  *
    1298. 

  1298.  * Existing options will not be updated. Note that prior to 3.3 this wasn't the case.
    1299. 

  1299.  *
    1300. 

  1300.  * @since 2.8.0
    1301. 

  1301.  * @since 4.4.0 Modified into wrapper for add_network_option()
    1302. 

  1302.  *
    1303. 

  1303.  * @see add_network_option()
    1304. 

  1304.  *
    1305. 

  1305.  * @param string $option Name of the option to add. Expected to not be SQL-escaped.
    1306. 

  1306.  * @param mixed  $value  Option value, can be anything. Expected to not be SQL-escaped.
    1307. 

  1307.  * @return bool True if the option was added, false otherwise.
    1308. 

  1308.  */
    1309. 

  1309. function add_site_option( $option, $value ) {
    1310. 

  1310. 	return add_network_option( null, $option, $value );
    1311. 

  1311. }
    1312. 

  1312. 

  1313. /**
    1314. 

  1314.  * Removes a option by name for the current network.
    1315. 

  1315.  *
    1316. 

  1316.  * @since 2.8.0
    1317. 

  1317.  * @since 4.4.0 Modified into wrapper for delete_network_option()
    1318. 

  1318.  *
    1319. 

  1319.  * @see delete_network_option()
    1320. 

  1320.  *
    1321. 

  1321.  * @param string $option Name of the option to delete. Expected to not be SQL-escaped.
    1322. 

  1322.  * @return bool True if the option was deleted, false otherwise.
    1323. 

  1323.  */
    1324. 

  1324. function delete_site_option( $option ) {
    1325. 

  1325. 	return delete_network_option( null, $option );
    1326. 

  1326. }
    1327. 

  1327. 

  1328. /**
    1329. 

  1329.  * Updates the value of an option that was already added for the current network.
    1330. 

  1330.  *
    1331. 

  1331.  * @since 2.8.0
    1332. 

  1332.  * @since 4.4.0 Modified into wrapper for update_network_option()
    1333. 

  1333.  *
    1334. 

  1334.  * @see update_network_option()
    1335. 

  1335.  *
    1336. 

  1336.  * @param string $option Name of the option. Expected to not be SQL-escaped.
    1337. 

  1337.  * @param mixed  $value  Option value. Expected to not be SQL-escaped.
    1338. 

  1338.  * @return bool True if the value was updated, false otherwise.
    1339. 

  1339.  */
    1340. 

  1340. function update_site_option( $option, $value ) {
    1341. 

  1341. 	return update_network_option( null, $option, $value );
    1342. 

  1342. }
    1343. 

  1343. 

  1344. /**
    1345. 

  1345.  * Retrieves a network's option value based on the option name.
    1346. 

  1346.  *
    1347. 

  1347.  * @since 4.4.0
    1348. 

  1348.  *
    1349. 

  1349.  * @see get_option()
    1350. 

  1350.  *
    1351. 

  1351.  * @global wpdb $wpdb WordPress database abstraction object.
    1352. 

  1352.  *
    1353. 

  1353.  * @param int    $network_id ID of the network. Can be null to default to the current network ID.
    1354. 

  1354.  * @param string $option     Name of the option to retrieve. Expected to not be SQL-escaped.
    1355. 

  1355.  * @param mixed  $default    Optional. Value to return if the option doesn't exist. Default false.
    1356. 

  1356.  * @return mixed Value set for the option.
    1357. 

  1357.  */
    1358. 

  1358. function get_network_option( $network_id, $option, $default = false ) {
    1359. 

  1359. 	global $wpdb;
    1360. 

  1360. 

  1361. 	if ( $network_id && ! is_numeric( $network_id ) ) {
    1362. 

  1362. 		return false;
    1363. 

  1363. 	}
    1364. 

  1364. 

  1365. 	$network_id = (int) $network_id;
    1366. 

  1366. 

  1367. 	// Fallback to the current network if a network ID is not specified.
    1368. 

  1368. 	if ( ! $network_id ) {
    1369. 

  1369. 		$network_id = get_current_network_id();
    1370. 

  1370. 	}
    1371. 

  1371. 

  1372. 	/**
    1373. 

  1373. 	 * Filters the value of an existing network option before it is retrieved.
    1374. 

  1374. 	 *
    1375. 

  1375. 	 * The dynamic portion of the hook name, `$option`, refers to the option name.
    1376. 

  1376. 	 *
    1377. 

  1377. 	 * Returning a truthy value from the filter will effectively short-circuit retrieval
    1378. 

  1378. 	 * and return the passed value instead.
    1379. 

  1379. 	 *
    1380. 

  1380. 	 * @since 2.9.0 As 'pre_site_option_' . $key
    1381. 

  1381. 	 * @since 3.0.0
    1382. 

  1382. 	 * @since 4.4.0 The `$option` parameter was added.
    1383. 

  1383. 	 * @since 4.7.0 The `$network_id` parameter was added.
    1384. 

  1384. 	 * @since 4.9.0 The `$default` parameter was added.
    1385. 

  1385. 	 *
    1386. 

  1386. 	 * @param mixed  $pre_option The value to return instead of the option value. This differs
    1387. 

  1387. 	 *                           from `$default`, which is used as the fallback value in the event
    1388. 

  1388. 	 *                           the option doesn't exist elsewhere in get_network_option().
    1389. 

  1389. 	 *                           Default false (to skip past the short-circuit).
    1390. 

  1390. 	 * @param string $option     Option name.
    1391. 

  1391. 	 * @param int    $network_id ID of the network.
    1392. 

  1392. 	 * @param mixed  $default    The fallback value to return if the option does not exist.
    1393. 

  1393. 	 *                           Default false.
    1394. 

  1394. 	 */
    1395. 

  1395. 	$pre = apply_filters( "pre_site_option_{$option}", false, $option, $network_id, $default );
    1396. 

  1396. 

  1397. 	if ( false !== $pre ) {
    1398. 

  1398. 		return $pre;
    1399. 

  1399. 	}
    1400. 

  1400. 

  1401. 	// Prevent non-existent options from triggering multiple queries.
    1402. 

  1402. 	$notoptions_key = "$network_id:notoptions";
    1403. 

  1403. 	$notoptions     = wp_cache_get( $notoptions_key, 'site-options' );
    1404. 

  1404. 

  1405. 	if ( is_array( $notoptions ) && isset( $notoptions[ $option ] ) ) {
    1406. 

  1406. 

  1407. 		/**
    1408. 

  1408. 		 * Filters a specific default network option.
    1409. 

  1409. 		 *
    1410. 

  1410. 		 * The dynamic portion of the hook name, `$option`, refers to the option name.
    1411. 

  1411. 		 *
    1412. 

  1412. 		 * @since 3.4.0
    1413. 

  1413. 		 * @since 4.4.0 The `$option` parameter was added.
    1414. 

  1414. 		 * @since 4.7.0 The `$network_id` parameter was added.
    1415. 

  1415. 		 *
    1416. 

  1416. 		 * @param mixed  $default    The value to return if the site option does not exist
    1417. 

  1417. 		 *                           in the database.
    1418. 

  1418. 		 * @param string $option     Option name.
    1419. 

  1419. 		 * @param int    $network_id ID of the network.
    1420. 

  1420. 		 */
    1421. 

  1421. 		return apply_filters( "default_site_option_{$option}", $default, $option, $network_id );
    1422. 

  1422. 	}
    1423. 

  1423. 

  1424. 	if ( ! is_multisite() ) {
    1425. 

  1425. 		/** This filter is documented in wp-includes/option.php */
    1426. 

  1426. 		$default = apply_filters( 'default_site_option_' . $option, $default, $option, $network_id );
    1427. 

  1427. 		$value   = get_option( $option, $default );
    1428. 

  1428. 	} else {
    1429. 

  1429. 		$cache_key = "$network_id:$option";
    1430. 

  1430. 		$value     = wp_cache_get( $cache_key, 'site-options' );
    1431. 

  1431. 

  1432. 		if ( ! isset( $value ) || false === $value ) {
    1433. 

  1433. 			$row = $wpdb->get_row( $wpdb->prepare( "SELECT meta_value FROM $wpdb->sitemeta WHERE meta_key = %s AND site_id = %d", $option, $network_id ) );
    1434. 

  1434. 

  1435. 			// Has to be get_row() instead of get_var() because of funkiness with 0, false, null values.
    1436. 

  1436. 			if ( is_object( $row ) ) {
    1437. 

  1437. 				$value = $row->meta_value;
    1438. 

  1438. 				$value = maybe_unserialize( $value );
    1439. 

  1439. 				wp_cache_set( $cache_key, $value, 'site-options' );
    1440. 

  1440. 			} else {
    1441. 

  1441. 				if ( ! is_array( $notoptions ) ) {
    1442. 

  1442. 					$notoptions = array();
    1443. 

  1443. 				}
    1444. 

  1444. 

  1445. 				$notoptions[ $option ] = true;
    1446. 

  1446. 				wp_cache_set( $notoptions_key, $notoptions, 'site-options' );
    1447. 

  1447. 

  1448. 				/** This filter is documented in wp-includes/option.php */
    1449. 

  1449. 				$value = apply_filters( 'default_site_option_' . $option, $default, $option, $network_id );
    1450. 

  1450. 			}
    1451. 

  1451. 		}
    1452. 

  1452. 	}
    1453. 

  1453. 

  1454. 	if ( ! is_array( $notoptions ) ) {
    1455. 

  1455. 		$notoptions = array();
    1456. 

  1456. 		wp_cache_set( $notoptions_key, $notoptions, 'site-options' );
    1457. 

  1457. 	}
    1458. 

  1458. 

  1459. 	/**
    1460. 

  1460. 	 * Filters the value of an existing network option.
    1461. 

  1461. 	 *
    1462. 

  1462. 	 * The dynamic portion of the hook name, `$option`, refers to the option name.
    1463. 

  1463. 	 *
    1464. 

  1464. 	 * @since 2.9.0 As 'site_option_' . $key
    1465. 

  1465. 	 * @since 3.0.0
    1466. 

  1466. 	 * @since 4.4.0 The `$option` parameter was added.
    1467. 

  1467. 	 * @since 4.7.0 The `$network_id` parameter was added.
    1468. 

  1468. 	 *
    1469. 

  1469. 	 * @param mixed  $value      Value of network option.
    1470. 

  1470. 	 * @param string $option     Option name.
    1471. 

  1471. 	 * @param int    $network_id ID of the network.
    1472. 

  1472. 	 */
    1473. 

  1473. 	return apply_filters( "site_option_{$option}", $value, $option, $network_id );
    1474. 

  1474. }
    1475. 

  1475. 

  1476. /**
    1477. 

  1477.  * Adds a new network option.
    1478. 

  1478.  *
    1479. 

  1479.  * Existing options will not be updated.
    1480. 

  1480.  *
    1481. 

  1481.  * @since 4.4.0
    1482. 

  1482.  *
    1483. 

  1483.  * @see add_option()
    1484. 

  1484.  *
    1485. 

  1485.  * @global wpdb $wpdb WordPress database abstraction object.
    1486. 

  1486.  *
    1487. 

  1487.  * @param int    $network_id ID of the network. Can be null to default to the current network ID.
    1488. 

  1488.  * @param string $option     Name of the option to add. Expected to not be SQL-escaped.
    1489. 

  1489.  * @param mixed  $value      Option value, can be anything. Expected to not be SQL-escaped.
    1490. 

  1490.  * @return bool True if the option was added, false otherwise.
    1491. 

  1491.  */
    1492. 

  1492. function add_network_option( $network_id, $option, $value ) {
    1493. 

  1493. 	global $wpdb;
    1494. 

  1494. 

  1495. 	if ( $network_id && ! is_numeric( $network_id ) ) {
    1496. 

  1496. 		return false;
    1497. 

  1497. 	}
    1498. 

  1498. 

  1499. 	$network_id = (int) $network_id;
    1500. 

  1500. 

  1501. 	// Fallback to the current network if a network ID is not specified.
    1502. 

  1502. 	if ( ! $network_id ) {
    1503. 

  1503. 		$network_id = get_current_network_id();
    1504. 

  1504. 	}
    1505. 

  1505. 

  1506. 	wp_protect_special_option( $option );
    1507. 

  1507. 

  1508. 	/**
    1509. 

  1509. 	 * Filters the value of a specific network option before it is added.
    1510. 

  1510. 	 *
    1511. 

  1511. 	 * The dynamic portion of the hook name, `$option`, refers to the option name.
    1512. 

  1512. 	 *
    1513. 

  1513. 	 * @since 2.9.0 As 'pre_add_site_option_' . $key
    1514. 

  1514. 	 * @since 3.0.0
    1515. 

  1515. 	 * @since 4.4.0 The `$option` parameter was added.
    1516. 

  1516. 	 * @since 4.7.0 The `$network_id` parameter was added.
    1517. 

  1517. 	 *
    1518. 

  1518. 	 * @param mixed  $value      Value of network option.
    1519. 

  1519. 	 * @param string $option     Option name.
    1520. 

  1520. 	 * @param int    $network_id ID of the network.
    1521. 

  1521. 	 */
    1522. 

  1522. 	$value = apply_filters( "pre_add_site_option_{$option}", $value, $option, $network_id );
    1523. 

  1523. 

  1524. 	$notoptions_key = "$network_id:notoptions";
    1525. 

  1525. 

  1526. 	if ( ! is_multisite() ) {
    1527. 

  1527. 		$result = add_option( $option, $value, '', 'no' );
    1528. 

  1528. 	} else {
    1529. 

  1529. 		$cache_key = "$network_id:$option";
    1530. 

  1530. 

  1531. 		// Make sure the option doesn't already exist.
    1532. 

  1532. 		// We can check the 'notoptions' cache before we ask for a DB query.
    1533. 

  1533. 		$notoptions = wp_cache_get( $notoptions_key, 'site-options' );
    1534. 

  1534. 

  1535. 		if ( ! is_array( $notoptions ) || ! isset( $notoptions[ $option ] ) ) {
    1536. 

  1536. 			if ( false !== get_network_option( $network_id, $option, false ) ) {
    1537. 

  1537. 				return false;
    1538. 

  1538. 			}
    1539. 

  1539. 		}
    1540. 

  1540. 

  1541. 		$value = sanitize_option( $option, $value );
    1542. 

  1542. 

  1543. 		$serialized_value = maybe_serialize( $value );
    1544. 

  1544. 		$result           = $wpdb->insert(
    1545. 

  1545. 			$wpdb->sitemeta,
    1546. 

  1546. 			array(
    1547. 

  1547. 				'site_id'    => $network_id,
    1548. 

  1548. 				'meta_key'   => $option,
    1549. 

  1549. 				'meta_value' => $serialized_value,
    1550. 

  1550. 			)
    1551. 

  1551. 		);
    1552. 

  1552. 

  1553. 		if ( ! $result ) {
    1554. 

  1554. 			return false;
    1555. 

  1555. 		}
    1556. 

  1556. 

  1557. 		wp_cache_set( $cache_key, $value, 'site-options' );
    1558. 

  1558. 

  1559. 		// This option exists now.
    1560. 

  1560. 		$notoptions = wp_cache_get( $notoptions_key, 'site-options' ); // Yes, again... we need it to be fresh.
    1561. 

  1561. 

  1562. 		if ( is_array( $notoptions ) && isset( $notoptions[ $option ] ) ) {
    1563. 

  1563. 			unset( $notoptions[ $option ] );
    1564. 

  1564. 			wp_cache_set( $notoptions_key, $notoptions, 'site-options' );
    1565. 

  1565. 		}
    1566. 

  1566. 	}
    1567. 

  1567. 

  1568. 	if ( $result ) {
    1569. 

  1569. 

  1570. 		/**
    1571. 

  1571. 		 * Fires after a specific network option has been successfully added.
    1572. 

  1572. 		 *
    1573. 

  1573. 		 * The dynamic portion of the hook name, `$option`, refers to the option name.
    1574. 

  1574. 		 *
    1575. 

  1575. 		 * @since 2.9.0 As "add_site_option_{$key}"
    1576. 

  1576. 		 * @since 3.0.0
    1577. 

  1577. 		 * @since 4.7.0 The `$network_id` parameter was added.
    1578. 

  1578. 		 *
    1579. 

  1579. 		 * @param string $option     Name of the network option.
    1580. 

  1580. 		 * @param mixed  $value      Value of the network option.
    1581. 

  1581. 		 * @param int    $network_id ID of the network.
    1582. 

  1582. 		 */
    1583. 

  1583. 		do_action( "add_site_option_{$option}", $option, $value, $network_id );
    1584. 

  1584. 

  1585. 		/**
    1586. 

  1586. 		 * Fires after a network option has been successfully added.
    1587. 

  1587. 		 *
    1588. 

  1588. 		 * @since 3.0.0
    1589. 

  1589. 		 * @since 4.7.0 The `$network_id` parameter was added.
    1590. 

  1590. 		 *
    1591. 

  1591. 		 * @param string $option     Name of the network option.
    1592. 

  1592. 		 * @param mixed  $value      Value of the network option.
    1593. 

  1593. 		 * @param int    $network_id ID of the network.
    1594. 

  1594. 		 */
    1595. 

  1595. 		do_action( 'add_site_option', $option, $value, $network_id );
    1596. 

  1596. 

  1597. 		return true;
    1598. 

  1598. 	}
    1599. 

  1599. 

  1600. 	return false;
    1601. 

  1601. }
    1602. 

  1602. 

  1603. /**
    1604. 

  1604.  * Removes a network option by name.
    1605. 

  1605.  *
    1606. 

  1606.  * @since 4.4.0
    1607. 

  1607.  *
    1608. 

  1608.  * @see delete_option()
    1609. 

  1609.  *
    1610. 

  1610.  * @global wpdb $wpdb WordPress database abstraction object.
    1611. 

  1611.  *
    1612. 

  1612.  * @param int    $network_id ID of the network. Can be null to default to the current network ID.
    1613. 

  1613.  * @param string $option     Name of the option to delete. Expected to not be SQL-escaped.
    1614. 

  1614.  * @return bool True if the option was deleted, false otherwise.
    1615. 

  1615.  */
    1616. 

  1616. function delete_network_option( $network_id, $option ) {
    1617. 

  1617. 	global $wpdb;
    1618. 

  1618. 

  1619. 	if ( $network_id && ! is_numeric( $network_id ) ) {
    1620. 

  1620. 		return false;
    1621. 

  1621. 	}
    1622. 

  1622. 

  1623. 	$network_id = (int) $network_id;
    1624. 

  1624. 

  1625. 	// Fallback to the current network if a network ID is not specified.
    1626. 

  1626. 	if ( ! $network_id ) {
    1627. 

  1627. 		$network_id = get_current_network_id();
    1628. 

  1628. 	}
    1629. 

  1629. 

  1630. 	/**
    1631. 

  1631. 	 * Fires immediately before a specific network option is deleted.
    1632. 

  1632. 	 *
    1633. 

  1633. 	 * The dynamic portion of the hook name, `$option`, refers to the option name.
    1634. 

  1634. 	 *
    1635. 

  1635. 	 * @since 3.0.0
    1636. 

  1636. 	 * @since 4.4.0 The `$option` parameter was added.
    1637. 

  1637. 	 * @since 4.7.0 The `$network_id` parameter was added.
    1638. 

  1638. 	 *
    1639. 

  1639. 	 * @param string $option     Option name.
    1640. 

  1640. 	 * @param int    $network_id ID of the network.
    1641. 

  1641. 	 */
    1642. 

  1642. 	do_action( "pre_delete_site_option_{$option}", $option, $network_id );
    1643. 

  1643. 

  1644. 	if ( ! is_multisite() ) {
    1645. 

  1645. 		$result = delete_option( $option );
    1646. 

  1646. 	} else {
    1647. 

  1647. 		$row = $wpdb->get_row( $wpdb->prepare( "SELECT meta_id FROM {$wpdb->sitemeta} WHERE meta_key = %s AND site_id = %d", $option, $network_id ) );
    1648. 

  1648. 		if ( is_null( $row ) || ! $row->meta_id ) {
    1649. 

  1649. 			return false;
    1650. 

  1650. 		}
    1651. 

  1651. 		$cache_key = "$network_id:$option";
    1652. 

  1652. 		wp_cache_delete( $cache_key, 'site-options' );
    1653. 

  1653. 

  1654. 		$result = $wpdb->delete(
    1655. 

  1655. 			$wpdb->sitemeta,
    1656. 

  1656. 			array(
    1657. 

  1657. 				'meta_key' => $option,
    1658. 

  1658. 				'site_id'  => $network_id,
    1659. 

  1659. 			)
    1660. 

  1660. 		);
    1661. 

  1661. 	}
    1662. 

  1662. 

  1663. 	if ( $result ) {
    1664. 

  1664. 

  1665. 		/**
    1666. 

  1666. 		 * Fires after a specific network option has been deleted.
    1667. 

  1667. 		 *
    1668. 

  1668. 		 * The dynamic portion of the hook name, `$option`, refers to the option name.
    1669. 

  1669. 		 *
    1670. 

  1670. 		 * @since 2.9.0 As "delete_site_option_{$key}"
    1671. 

  1671. 		 * @since 3.0.0
    1672. 

  1672. 		 * @since 4.7.0 The `$network_id` parameter was added.
    1673. 

  1673. 		 *
    1674. 

  1674. 		 * @param string $option     Name of the network option.
    1675. 

  1675. 		 * @param int    $network_id ID of the network.
    1676. 

  1676. 		 */
    1677. 

  1677. 		do_action( "delete_site_option_{$option}", $option, $network_id );
    1678. 

  1678. 

  1679. 		/**
    1680. 

  1680. 		 * Fires after a network option has been deleted.
    1681. 

  1681. 		 *
    1682. 

  1682. 		 * @since 3.0.0
    1683. 

  1683. 		 * @since 4.7.0 The `$network_id` parameter was added.
    1684. 

  1684. 		 *
    1685. 

  1685. 		 * @param string $option     Name of the network option.
    1686. 

  1686. 		 * @param int    $network_id ID of the network.
    1687. 

  1687. 		 */
    1688. 

  1688. 		do_action( 'delete_site_option', $option, $network_id );
    1689. 

  1689. 

  1690. 		return true;
    1691. 

  1691. 	}
    1692. 

  1692. 

  1693. 	return false;
    1694. 

  1694. }
    1695. 

  1695. 

  1696. /**
    1697. 

  1697.  * Updates the value of a network option that was already added.
    1698. 

  1698.  *
    1699. 

  1699.  * @since 4.4.0
    1700. 

  1700.  *
    1701. 

  1701.  * @see update_option()
    1702. 

  1702.  *
    1703. 

  1703.  * @global wpdb $wpdb WordPress database abstraction object.
    1704. 

  1704.  *
    1705. 

  1705.  * @param int    $network_id ID of the network. Can be null to default to the current network ID.
    1706. 

  1706.  * @param string $option     Name of the option. Expected to not be SQL-escaped.
    1707. 

  1707.  * @param mixed  $value      Option value. Expected to not be SQL-escaped.
    1708. 

  1708.  * @return bool True if the value was updated, false otherwise.
    1709. 

  1709.  */
    1710. 

  1710. function update_network_option( $network_id, $option, $value ) {
    1711. 

  1711. 	global $wpdb;
    1712. 

  1712. 

  1713. 	if ( $network_id && ! is_numeric( $network_id ) ) {
    1714. 

  1714. 		return false;
    1715. 

  1715. 	}
    1716. 

  1716. 

  1717. 	$network_id = (int) $network_id;
    1718. 

  1718. 

  1719. 	// Fallback to the current network if a network ID is not specified.
    1720. 

  1720. 	if ( ! $network_id ) {
    1721. 

  1721. 		$network_id = get_current_network_id();
    1722. 

  1722. 	}
    1723. 

  1723. 

  1724. 	wp_protect_special_option( $option );
    1725. 

  1725. 

  1726. 	$old_value = get_network_option( $network_id, $option, false );
    1727. 

  1727. 

  1728. 	/**
    1729. 

  1729. 	 * Filters a specific network option before its value is updated.
    1730. 

  1730. 	 *
    1731. 

  1731. 	 * The dynamic portion of the hook name, `$option`, refers to the option name.
    1732. 

  1732. 	 *
    1733. 

  1733. 	 * @since 2.9.0 As 'pre_update_site_option_' . $key
    1734. 

  1734. 	 * @since 3.0.0
    1735. 

  1735. 	 * @since 4.4.0 The `$option` parameter was added.
    1736. 

  1736. 	 * @since 4.7.0 The `$network_id` parameter was added.
    1737. 

  1737. 	 *
    1738. 

  1738. 	 * @param mixed  $value      New value of the network option.
    1739. 

  1739. 	 * @param mixed  $old_value  Old value of the network option.
    1740. 

  1740. 	 * @param string $option     Option name.
    1741. 

  1741. 	 * @param int    $network_id ID of the network.
    1742. 

  1742. 	 */
    1743. 

  1743. 	$value = apply_filters( "pre_update_site_option_{$option}", $value, $old_value, $option, $network_id );
    1744. 

  1744. 

  1745. 	/*
    1746. 

  1746. 	 * If the new and old values are the same, no need to update.
    1747. 

  1747. 	 *
    1748. 

  1748. 	 * Unserialized values will be adequate in most cases. If the unserialized
    1749. 

  1749. 	 * data differs, the (maybe) serialized data is checked to avoid
    1750. 

  1750. 	 * unnecessary database calls for otherwise identical object instances.
    1751. 

  1751. 	 *
    1752. 

  1752. 	 * See https://core.trac.wordpress.org/ticket/44956
    1753. 

  1753. 	 */
    1754. 

  1754. 	if ( $value === $old_value || maybe_serialize( $value ) === maybe_serialize( $old_value ) ) {
    1755. 

  1755. 		return false;
    1756. 

  1756. 	}
    1757. 

  1757. 

  1758. 	if ( false === $old_value ) {
    1759. 

  1759. 		return add_network_option( $network_id, $option, $value );
    1760. 

  1760. 	}
    1761. 

  1761. 

  1762. 	$notoptions_key = "$network_id:notoptions";
    1763. 

  1763. 	$notoptions     = wp_cache_get( $notoptions_key, 'site-options' );
    1764. 

  1764. 

  1765. 	if ( is_array( $notoptions ) && isset( $notoptions[ $option ] ) ) {
    1766. 

  1766. 		unset( $notoptions[ $option ] );
    1767. 

  1767. 		wp_cache_set( $notoptions_key, $notoptions, 'site-options' );
    1768. 

  1768. 	}
    1769. 

  1769. 

  1770. 	if ( ! is_multisite() ) {
    1771. 

  1771. 		$result = update_option( $option, $value, 'no' );
    1772. 

  1772. 	} else {
    1773. 

  1773. 		$value = sanitize_option( $option, $value );
    1774. 

  1774. 

  1775. 		$serialized_value = maybe_serialize( $value );
    1776. 

  1776. 		$result           = $wpdb->update(
    1777. 

  1777. 			$wpdb->sitemeta,
    1778. 

  1778. 			array( 'meta_value' => $serialized_value ),
    1779. 

  1779. 			array(
    1780. 

  1780. 				'site_id'  => $network_id,
    1781. 

  1781. 				'meta_key' => $option,
    1782. 

  1782. 			)
    1783. 

  1783. 		);
    1784. 

  1784. 

  1785. 		if ( $result ) {
    1786. 

  1786. 			$cache_key = "$network_id:$option";
    1787. 

  1787. 			wp_cache_set( $cache_key, $value, 'site-options' );
    1788. 

  1788. 		}
    1789. 

  1789. 	}
    1790. 

  1790. 

  1791. 	if ( $result ) {
    1792. 

  1792. 

  1793. 		/**
    1794. 

  1794. 		 * Fires after the value of a specific network option has been successfully updated.
    1795. 

  1795. 		 *
    1796. 

  1796. 		 * The dynamic portion of the hook name, `$option`, refers to the option name.
    1797. 

  1797. 		 *
    1798. 

  1798. 		 * @since 2.9.0 As "update_site_option_{$key}"
    1799. 

  1799. 		 * @since 3.0.0
    1800. 

  1800. 		 * @since 4.7.0 The `$network_id` parameter was added.
    1801. 

  1801. 		 *
    1802. 

  1802. 		 * @param string $option     Name of the network option.
    1803. 

  1803. 		 * @param mixed  $value      Current value of the network option.
    1804. 

  1804. 		 * @param mixed  $old_value  Old value of the network option.
    1805. 

  1805. 		 * @param int    $network_id ID of the network.
    1806. 

  1806. 		 */
    1807. 

  1807. 		do_action( "update_site_option_{$option}", $option, $value, $old_value, $network_id );
    1808. 

  1808. 

  1809. 		/**
    1810. 

  1810. 		 * Fires after the value of a network option has been successfully updated.
    1811. 

  1811. 		 *
    1812. 

  1812. 		 * @since 3.0.0
    1813. 

  1813. 		 * @since 4.7.0 The `$network_id` parameter was added.
    1814. 

  1814. 		 *
    1815. 

  1815. 		 * @param string $option     Name of the network option.
    1816. 

  1816. 		 * @param mixed  $value      Current value of the network option.
    1817. 

  1817. 		 * @param mixed  $old_value  Old value of the network option.
    1818. 

  1818. 		 * @param int    $network_id ID of the network.
    1819. 

  1819. 		 */
    1820. 

  1820. 		do_action( 'update_site_option', $option, $value, $old_value, $network_id );
    1821. 

  1821. 

  1822. 		return true;
    1823. 

  1823. 	}
    1824. 

  1824. 

  1825. 	return false;
    1826. 

  1826. }
    1827. 

  1827. 

  1828. /**
    1829. 

  1829.  * Deletes a site transient.
    1830. 

  1830.  *
    1831. 

  1831.  * @since 2.9.0
    1832. 

  1832.  *
    1833. 

  1833.  * @param string $transient Transient name. Expected to not be SQL-escaped.
    1834. 

  1834.  * @return bool True if the transient was deleted, false otherwise.
    1835. 

  1835.  */
    1836. 

  1836. function delete_site_transient( $transient ) {
    1837. 

  1837. 

  1838. 	/**
    1839. 

  1839. 	 * Fires immediately before a specific site transient is deleted.
    1840. 

  1840. 	 *
    1841. 

  1841. 	 * The dynamic portion of the hook name, `$transient`, refers to the transient name.
    1842. 

  1842. 	 *
    1843. 

  1843. 	 * @since 3.0.0
    1844. 

  1844. 	 *
    1845. 

  1845. 	 * @param string $transient Transient name.
    1846. 

  1846. 	 */
    1847. 

  1847. 	do_action( "delete_site_transient_{$transient}", $transient );
    1848. 

  1848. 

  1849. 	if ( wp_using_ext_object_cache() ) {
    1850. 

  1850. 		$result = wp_cache_delete( $transient, 'site-transient' );
    1851. 

  1851. 	} else {
    1852. 

  1852. 		$option_timeout = '_site_transient_timeout_' . $transient;
    1853. 

  1853. 		$option         = '_site_transient_' . $transient;
    1854. 

  1854. 		$result         = delete_site_option( $option );
    1855. 

  1855. 

  1856. 		if ( $result ) {
    1857. 

  1857. 			delete_site_option( $option_timeout );
    1858. 

  1858. 		}
    1859. 

  1859. 	}
    1860. 

  1860. 

  1861. 	if ( $result ) {
    1862. 

  1862. 

  1863. 		/**
    1864. 

  1864. 		 * Fires after a transient is deleted.
    1865. 

  1865. 		 *
    1866. 

  1866. 		 * @since 3.0.0
    1867. 

  1867. 		 *
    1868. 

  1868. 		 * @param string $transient Deleted transient name.
    1869. 

  1869. 		 */
    1870. 

  1870. 		do_action( 'deleted_site_transient', $transient );
    1871. 

  1871. 	}
    1872. 

  1872. 

  1873. 	return $result;
    1874. 

  1874. }
    1875. 

  1875. 

  1876. /**
    1877. 

  1877.  * Retrieves the value of a site transient.
    1878. 

  1878.  *
    1879. 

  1879.  * If the transient does not exist, does not have a value, or has expired,
    1880. 

  1880.  * then the return value will be false.
    1881. 

  1881.  *
    1882. 

  1882.  * @since 2.9.0
    1883. 

  1883.  *
    1884. 

  1884.  * @see get_transient()
    1885. 

  1885.  *
    1886. 

  1886.  * @param string $transient Transient name. Expected to not be SQL-escaped.
    1887. 

  1887.  * @return mixed Value of transient.
    1888. 

  1888.  */
    1889. 

  1889. function get_site_transient( $transient ) {
    1890. 

  1890. 

  1891. 	/**
    1892. 

  1892. 	 * Filters the value of an existing site transient before it is retrieved.
    1893. 

  1893. 	 *
    1894. 

  1894. 	 * The dynamic portion of the hook name, `$transient`, refers to the transient name.
    1895. 

  1895. 	 *
    1896. 

  1896. 	 * Returning a truthy value from the filter will effectively short-circuit retrieval
    1897. 

  1897. 	 * and return the passed value instead.
    1898. 

  1898. 	 *
    1899. 

  1899. 	 * @since 2.9.0
    1900. 

  1900. 	 * @since 4.4.0 The `$transient` parameter was added.
    1901. 

  1901. 	 *
    1902. 

  1902. 	 * @param mixed  $pre_site_transient The default value to return if the site transient does not exist.
    1903. 

  1903. 	 *                                   Any value other than false will short-circuit the retrieval
    1904. 

  1904. 	 *                                   of the transient, and return that value.
    1905. 

  1905. 	 * @param string $transient          Transient name.
    1906. 

  1906. 	 */
    1907. 

  1907. 	$pre = apply_filters( "pre_site_transient_{$transient}", false, $transient );
    1908. 

  1908. 

  1909. 	if ( false !== $pre ) {
    1910. 

  1910. 		return $pre;
    1911. 

  1911. 	}
    1912. 

  1912. 

  1913. 	if ( wp_using_ext_object_cache() ) {
    1914. 

  1914. 		$value = wp_cache_get( $transient, 'site-transient' );
    1915. 

  1915. 	} else {
    1916. 

  1916. 		// Core transients that do not have a timeout. Listed here so querying timeouts can be avoided.
    1917. 

  1917. 		$no_timeout       = array( 'update_core', 'update_plugins', 'update_themes' );
    1918. 

  1918. 		$transient_option = '_site_transient_' . $transient;
    1919. 

  1919. 		if ( ! in_array( $transient, $no_timeout, true ) ) {
    1920. 

  1920. 			$transient_timeout = '_site_transient_timeout_' . $transient;
    1921. 

  1921. 			$timeout           = get_site_option( $transient_timeout );
    1922. 

  1922. 			if ( false !== $timeout && $timeout < time() ) {
    1923. 

  1923. 				delete_site_option( $transient_option );
    1924. 

  1924. 				delete_site_option( $transient_timeout );
    1925. 

  1925. 				$value = false;
    1926. 

  1926. 			}
    1927. 

  1927. 		}
    1928. 

  1928. 

  1929. 		if ( ! isset( $value ) ) {
    1930. 

  1930. 			$value = get_site_option( $transient_option );
    1931. 

  1931. 		}
    1932. 

  1932. 	}
    1933. 

  1933. 

  1934. 	/**
    1935. 

  1935. 	 * Filters the value of an existing site transient.
    1936. 

  1936. 	 *
    1937. 

  1937. 	 * The dynamic portion of the hook name, `$transient`, refers to the transient name.
    1938. 

  1938. 	 *
    1939. 

  1939. 	 * @since 2.9.0
    1940. 

  1940. 	 * @since 4.4.0 The `$transient` parameter was added.
    1941. 

  1941. 	 *
    1942. 

  1942. 	 * @param mixed  $value     Value of site transient.
    1943. 

  1943. 	 * @param string $transient Transient name.
    1944. 

  1944. 	 */
    1945. 

  1945. 	return apply_filters( "site_transient_{$transient}", $value, $transient );
    1946. 

  1946. }
    1947. 

  1947. 

  1948. /**
    1949. 

  1949.  * Sets/updates the value of a site transient.
    1950. 

  1950.  *
    1951. 

  1951.  * You do not need to serialize values. If the value needs to be serialized,
    1952. 

  1952.  * then it will be serialized before it is set.
    1953. 

  1953.  *
    1954. 

  1954.  * @since 2.9.0
    1955. 

  1955.  *
    1956. 

  1956.  * @see set_transient()
    1957. 

  1957.  *
    1958. 

  1958.  * @param string $transient  Transient name. Expected to not be SQL-escaped. Must be
    1959. 

  1959.  *                           167 characters or fewer in length.
    1960. 

  1960.  * @param mixed  $value      Transient value. Expected to not be SQL-escaped.
    1961. 

  1961.  * @param int    $expiration Optional. Time until expiration in seconds. Default 0 (no expiration).
    1962. 

  1962.  * @return bool True if the value was set, false otherwise.
    1963. 

  1963.  */
    1964. 

  1964. function set_site_transient( $transient, $value, $expiration = 0 ) {
    1965. 

  1965. 

  1966. 	/**
    1967. 

  1967. 	 * Filters the value of a specific site transient before it is set.
    1968. 

  1968. 	 *
    1969. 

  1969. 	 * The dynamic portion of the hook name, `$transient`, refers to the transient name.
    1970. 

  1970. 	 *
    1971. 

  1971. 	 * @since 3.0.0
    1972. 

  1972. 	 * @since 4.4.0 The `$transient` parameter was added.
    1973. 

  1973. 	 *
    1974. 

  1974. 	 * @param mixed  $value     New value of site transient.
    1975. 

  1975. 	 * @param string $transient Transient name.
    1976. 

  1976. 	 */
    1977. 

  1977. 	$value = apply_filters( "pre_set_site_transient_{$transient}", $value, $transient );
    1978. 

  1978. 

  1979. 	$expiration = (int) $expiration;
    1980. 

  1980. 

  1981. 	/**
    1982. 

  1982. 	 * Filters the expiration for a site transient before its value is set.
    1983. 

  1983. 	 *
    1984. 

  1984. 	 * The dynamic portion of the hook name, `$transient`, refers to the transient name.
    1985. 

  1985. 	 *
    1986. 

  1986. 	 * @since 4.4.0
    1987. 

  1987. 	 *
    1988. 

  1988. 	 * @param int    $expiration Time until expiration in seconds. Use 0 for no expiration.
    1989. 

  1989. 	 * @param mixed  $value      New value of site transient.
    1990. 

  1990. 	 * @param string $transient  Transient name.
    1991. 

  1991. 	 */
    1992. 

  1992. 	$expiration = apply_filters( "expiration_of_site_transient_{$transient}", $expiration, $value, $transient );
    1993. 

  1993. 

  1994. 	if ( wp_using_ext_object_cache() ) {
    1995. 

  1995. 		$result = wp_cache_set( $transient, $value, 'site-transient', $expiration );
    1996. 

  1996. 	} else {
    1997. 

  1997. 		$transient_timeout = '_site_transient_timeout_' . $transient;
    1998. 

  1998. 		$option            = '_site_transient_' . $transient;
    1999. 

  1999. 

  2000. 		if ( false === get_site_option( $option ) ) {
    2001. 

  2001. 			if ( $expiration ) {
    2002. 

  2002. 				add_site_option( $transient_timeout, time() + $expiration );
    2003. 

  2003. 			}
    2004. 

  2004. 			$result = add_site_option( $option, $value );
    2005. 

  2005. 		} else {
    2006. 

  2006. 			if ( $expiration ) {
    2007. 

  2007. 				update_site_option( $transient_timeout, time() + $expiration );
    2008. 

  2008. 			}
    2009. 

  2009. 			$result = update_site_option( $option, $value );
    2010. 

  2010. 		}
    2011. 

  2011. 	}
    2012. 

  2012. 

  2013. 	if ( $result ) {
    2014. 

  2014. 

  2015. 		/**
    2016. 

  2016. 		 * Fires after the value for a specific site transient has been set.
    2017. 

  2017. 		 *
    2018. 

  2018. 		 * The dynamic portion of the hook name, `$transient`, refers to the transient name.
    2019. 

  2019. 		 *
    2020. 

  2020. 		 * @since 3.0.0
    2021. 

  2021. 		 * @since 4.4.0 The `$transient` parameter was added
    2022. 

  2022. 		 *
    2023. 

  2023. 		 * @param mixed  $value      Site transient value.
    2024. 

  2024. 		 * @param int    $expiration Time until expiration in seconds.
    2025. 

  2025. 		 * @param string $transient  Transient name.
    2026. 

  2026. 		 */
    2027. 

  2027. 		do_action( "set_site_transient_{$transient}", $value, $expiration, $transient );
    2028. 

  2028. 

  2029. 		/**
    2030. 

  2030. 		 * Fires after the value for a site transient has been set.
    2031. 

  2031. 		 *
    2032. 

  2032. 		 * @since 3.0.0
    2033. 

  2033. 		 *
    2034. 

  2034. 		 * @param string $transient  The name of the site transient.
    2035. 

  2035. 		 * @param mixed  $value      Site transient value.
    2036. 

  2036. 		 * @param int    $expiration Time until expiration in seconds.
    2037. 

  2037. 		 */
    2038. 

  2038. 		do_action( 'setted_site_transient', $transient, $value, $expiration );
    2039. 

  2039. 	}
    2040. 

  2040. 

  2041. 	return $result;
    2042. 

  2042. }
    2043. 

  2043. 

  2044. /**
    2045. 

  2045.  * Registers default settings available in WordPress.
    2046. 

  2046.  *
    2047. 

  2047.  * The settings registered here are primarily useful for the REST API, so this
    2048. 

  2048.  * does not encompass all settings available in WordPress.
    2049. 

  2049.  *
    2050. 

  2050.  * @since 4.7.0
    2051. 

  2051.  */
    2052. 

  2052. function register_initial_settings() {
    2053. 

  2053. 	register_setting(
    2054. 

  2054. 		'general',
    2055. 

  2055. 		'blogname',
    2056. 

  2056. 		array(
    2057. 

  2057. 			'show_in_rest' => array(
    2058. 

  2058. 				'name' => 'title',
    2059. 

  2059. 			),
    2060. 

  2060. 			'type'         => 'string',
    2061. 

  2061. 			'description'  => __( 'Site title.' ),
    2062. 

  2062. 		)
    2063. 

  2063. 	);
    2064. 

  2064. 

  2065. 	register_setting(
    2066. 

  2066. 		'general',
    2067. 

  2067. 		'blogdescription',
    2068. 

  2068. 		array(
    2069. 

  2069. 			'show_in_rest' => array(
    2070. 

  2070. 				'name' => 'description',
    2071. 

  2071. 			),
    2072. 

  2072. 			'type'         => 'string',
    2073. 

  2073. 			'description'  => __( 'Site tagline.' ),
    2074. 

  2074. 		)
    2075. 

  2075. 	);
    2076. 

  2076. 

  2077. 	if ( ! is_multisite() ) {
    2078. 

  2078. 		register_setting(
    2079. 

  2079. 			'general',
    2080. 

  2080. 			'siteurl',
    2081. 

  2081. 			array(
    2082. 

  2082. 				'show_in_rest' => array(
    2083. 

  2083. 					'name'   => 'url',
    2084. 

  2084. 					'schema' => array(
    2085. 

  2085. 						'format' => 'uri',
    2086. 

  2086. 					),
    2087. 

  2087. 				),
    2088. 

  2088. 				'type'         => 'string',
    2089. 

  2089. 				'description'  => __( 'Site URL.' ),
    2090. 

  2090. 			)
    2091. 

  2091. 		);
    2092. 

  2092. 	}
    2093. 

  2093. 

  2094. 	if ( ! is_multisite() ) {
    2095. 

  2095. 		register_setting(
    2096. 

  2096. 			'general',
    2097. 

  2097. 			'admin_email',
    2098. 

  2098. 			array(
    2099. 

  2099. 				'show_in_rest' => array(
    2100. 

  2100. 					'name'   => 'email',
    2101. 

  2101. 					'schema' => array(
    2102. 

  2102. 						'format' => 'email',
    2103. 

  2103. 					),
    2104. 

  2104. 				),
    2105. 

  2105. 				'type'         => 'string',
    2106. 

  2106. 				'description'  => __( 'This address is used for admin purposes, like new user notification.' ),
    2107. 

  2107. 			)
    2108. 

  2108. 		);
    2109. 

  2109. 	}
    2110. 

  2110. 

  2111. 	register_setting(
    2112. 

  2112. 		'general',
    2113. 

  2113. 		'timezone_string',
    2114. 

  2114. 		array(
    2115. 

  2115. 			'show_in_rest' => array(
    2116. 

  2116. 				'name' => 'timezone',
    2117. 

  2117. 			),
    2118. 

  2118. 			'type'         => 'string',
    2119. 

  2119. 			'description'  => __( 'A city in the same timezone as you.' ),
    2120. 

  2120. 		)
    2121. 

  2121. 	);
    2122. 

  2122. 

  2123. 	register_setting(
    2124. 

  2124. 		'general',
    2125. 

  2125. 		'date_format',
    2126. 

  2126. 		array(
    2127. 

  2127. 			'show_in_rest' => true,
    2128. 

  2128. 			'type'         => 'string',
    2129. 

  2129. 			'description'  => __( 'A date format for all date strings.' ),
    2130. 

  2130. 		)
    2131. 

  2131. 	);
    2132. 

  2132. 

  2133. 	register_setting(
    2134. 

  2134. 		'general',
    2135. 

  2135. 		'time_format',
    2136. 

  2136. 		array(
    2137. 

  2137. 			'show_in_rest' => true,
    2138. 

  2138. 			'type'         => 'string',
    2139. 

  2139. 			'description'  => __( 'A time format for all time strings.' ),
    2140. 

  2140. 		)
    2141. 

  2141. 	);
    2142. 

  2142. 

  2143. 	register_setting(
    2144. 

  2144. 		'general',
    2145. 

  2145. 		'start_of_week',
    2146. 

  2146. 		array(
    2147. 

  2147. 			'show_in_rest' => true,
    2148. 

  2148. 			'type'         => 'integer',
    2149. 

  2149. 			'description'  => __( 'A day number of the week that the week should start on.' ),
    2150. 

  2150. 		)
    2151. 

  2151. 	);
    2152. 

  2152. 

  2153. 	register_setting(
    2154. 

  2154. 		'general',
    2155. 

  2155. 		'WPLANG',
    2156. 

  2156. 		array(
    2157. 

  2157. 			'show_in_rest' => array(
    2158. 

  2158. 				'name' => 'language',
    2159. 

  2159. 			),
    2160. 

  2160. 			'type'         => 'string',
    2161. 

  2161. 			'description'  => __( 'WordPress locale code.' ),
    2162. 

  2162. 			'default'      => 'en_US',
    2163. 

  2163. 		)
    2164. 

  2164. 	);
    2165. 

  2165. 

  2166. 	register_setting(
    2167. 

  2167. 		'writing',
    2168. 

  2168. 		'use_smilies',
    2169. 

  2169. 		array(
    2170. 

  2170. 			'show_in_rest' => true,
    2171. 

  2171. 			'type'         => 'boolean',
    2172. 

  2172. 			'description'  => __( 'Convert emoticons like :-) and :-P to graphics on display.' ),
    2173. 

  2173. 			'default'      => true,
    2174. 

  2174. 		)
    2175. 

  2175. 	);
    2176. 

  2176. 

  2177. 	register_setting(
    2178. 

  2178. 		'writing',
    2179. 

  2179. 		'default_category',
    2180. 

  2180. 		array(
    2181. 

  2181. 			'show_in_rest' => true,
    2182. 

  2182. 			'type'         => 'integer',
    2183. 

  2183. 			'description'  => __( 'Default post category.' ),
    2184. 

  2184. 		)
    2185. 

  2185. 	);
    2186. 

  2186. 

  2187. 	register_setting(
    2188. 

  2188. 		'writing',
    2189. 

  2189. 		'default_post_format',
    2190. 

  2190. 		array(
    2191. 

  2191. 			'show_in_rest' => true,
    2192. 

  2192. 			'type'         => 'string',
    2193. 

  2193. 			'description'  => __( 'Default post format.' ),
    2194. 

  2194. 		)
    2195. 

  2195. 	);
    2196. 

  2196. 

  2197. 	register_setting(
    2198. 

  2198. 		'reading',
    2199. 

  2199. 		'posts_per_page',
    2200. 

  2200. 		array(
    2201. 

  2201. 			'show_in_rest' => true,
    2202. 

  2202. 			'type'         => 'integer',
    2203. 

  2203. 			'description'  => __( 'Blog pages show at most.' ),
    2204. 

  2204. 			'default'      => 10,
    2205. 

  2205. 		)
    2206. 

  2206. 	);
    2207. 

  2207. 

  2208. 	register_setting(
    2209. 

  2209. 		'discussion',
    2210. 

  2210. 		'default_ping_status',
    2211. 

  2211. 		array(
    2212. 

  2212. 			'show_in_rest' => array(
    2213. 

  2213. 				'schema' => array(
    2214. 

  2214. 					'enum' => array( 'open', 'closed' ),
    2215. 

  2215. 				),
    2216. 

  2216. 			),
    2217. 

  2217. 			'type'         => 'string',
    2218. 

  2218. 			'description'  => __( 'Allow link notifications from other blogs (pingbacks and trackbacks) on new articles.' ),
    2219. 

  2219. 		)
    2220. 

  2220. 	);
    2221. 

  2221. 

  2222. 	register_setting(
    2223. 

  2223. 		'discussion',
    2224. 

  2224. 		'default_comment_status',
    2225. 

  2225. 		array(
    2226. 

  2226. 			'show_in_rest' => array(
    2227. 

  2227. 				'schema' => array(
    2228. 

  2228. 					'enum' => array( 'open', 'closed' ),
    2229. 

  2229. 				),
    2230. 

  2230. 			),
    2231. 

  2231. 			'type'         => 'string',
    2232. 

  2232. 			'description'  => __( 'Allow people to submit comments on new posts.' ),
    2233. 

  2233. 		)
    2234. 

  2234. 	);
    2235. 

  2235. }
    2236. 

  2236. 

  2237. /**
    2238. 

  2238.  * Registers a setting and its data.
    2239. 

  2239.  *
    2240. 

  2240.  * @since 2.7.0
    2241. 

  2241.  * @since 4.7.0 `$args` can be passed to set flags on the setting, similar to `register_meta()`.
    2242. 

  2242.  * @since 5.5.0 `$new_whitelist_options` was renamed to `$new_allowed_options`.
    2243. 

  2243.  *              Please consider writing more inclusive code.
    2244. 

  2244.  *
    2245. 

  2245.  * @global array $new_allowed_options
    2246. 

  2246.  * @global array $wp_registered_settings
    2247. 

  2247.  *
    2248. 

  2248.  * @param string $option_group A settings group name. Should correspond to an allowed option key name.
    2249. 

  2249.  *                             Default allowed option key names include 'general', 'discussion', 'media',
    2250. 

  2250.  *                             'reading', 'writing', 'misc', 'options', and 'privacy'.
    2251. 

  2251.  * @param string $option_name The name of an option to sanitize and save.
    2252. 

  2252.  * @param array  $args {
    2253. 

  2253.  *     Data used to describe the setting when registered.
    2254. 

  2254.  *
    2255. 

  2255.  *     @type string     $type              The type of data associated with this setting.
    2256. 

  2256.  *                                         Valid values are 'string', 'boolean', 'integer', 'number', 'array', and 'object'.
    2257. 

  2257.  *     @type string     $description       A description of the data attached to this setting.
    2258. 

  2258.  *     @type callable   $sanitize_callback A callback function that sanitizes the option's value.
    2259. 

  2259.  *     @type bool|array $show_in_rest      Whether data associated with this setting should be included in the REST API.
    2260. 

  2260.  *                                         When registering complex settings, this argument may optionally be an
    2261. 

  2261.  *                                         array with a 'schema' key.
    2262. 

  2262.  *     @type mixed      $default           Default value when calling `get_option()`.
    2263. 

  2263.  * }
    2264. 

  2264.  */
    2265. 

  2265. function register_setting( $option_group, $option_name, $args = array() ) {
    2266. 

  2266. 	global $new_allowed_options, $wp_registered_settings;
    2267. 

  2267. 

  2268. 	/*
    2269. 

  2269. 	 * In 5.5.0, the `$new_whitelist_options` global variable was renamed to `$new_allowed_options`.
    2270. 

  2270. 	 * Please consider writing more inclusive code.
    2271. 

  2271. 	 */
    2272. 

  2272. 	$GLOBALS['new_whitelist_options'] = &$new_allowed_options;
    2273. 

  2273. 

  2274. 	$defaults = array(
    2275. 

  2275. 		'type'              => 'string',
    2276. 

  2276. 		'group'             => $option_group,
    2277. 

  2277. 		'description'       => '',
    2278. 

  2278. 		'sanitize_callback' => null,
    2279. 

  2279. 		'show_in_rest'      => false,
    2280. 

  2280. 	);
    2281. 

  2281. 

  2282. 	// Back-compat: old sanitize callback is added.
    2283. 

  2283. 	if ( is_callable( $args ) ) {
    2284. 

  2284. 		$args = array(
    2285. 

  2285. 			'sanitize_callback' => $args,
    2286. 

  2286. 		);
    2287. 

  2287. 	}
    2288. 

  2288. 

  2289. 	/**
    2290. 

  2290. 	 * Filters the registration arguments when registering a setting.
    2291. 

  2291. 	 *
    2292. 

  2292. 	 * @since 4.7.0
    2293. 

  2293. 	 *
    2294. 

  2294. 	 * @param array  $args         Array of setting registration arguments.
    2295. 

  2295. 	 * @param array  $defaults     Array of default arguments.
    2296. 

  2296. 	 * @param string $option_group Setting group.
    2297. 

  2297. 	 * @param string $option_name  Setting name.
    2298. 

  2298. 	 */
    2299. 

  2299. 	$args = apply_filters( 'register_setting_args', $args, $defaults, $option_group, $option_name );
    2300. 

  2300. 

  2301. 	$args = wp_parse_args( $args, $defaults );
    2302. 

  2302. 

  2303. 	// Require an item schema when registering settings with an array type.
    2304. 

  2304. 	if ( false !== $args['show_in_rest'] && 'array' === $args['type'] && ( ! is_array( $args['show_in_rest'] ) || ! isset( $args['show_in_rest']['schema']['items'] ) ) ) {
    2305. 

  2305. 		_doing_it_wrong( __FUNCTION__, __( 'When registering an "array" setting to show in the REST API, you must specify the schema for each array item in "show_in_rest.schema.items".' ), '5.4.0' );
    2306. 

  2306. 	}
    2307. 

  2307. 

  2308. 	if ( ! is_array( $wp_registered_settings ) ) {
    2309. 

  2309. 		$wp_registered_settings = array();
    2310. 

  2310. 	}
    2311. 

  2311. 

  2312. 	if ( 'misc' === $option_group ) {
    2313. 

  2313. 		_deprecated_argument(
    2314. 

  2314. 			__FUNCTION__,
    2315. 

  2315. 			'3.0.0',
    2316. 

  2316. 			sprintf(
    2317. 

  2317. 				/* translators: %s: misc */
    2318. 

  2318. 				__( 'The "%s" options group has been removed. Use another settings group.' ),
    2319. 

  2319. 				'misc'
    2320. 

  2320. 			)
    2321. 

  2321. 		);
    2322. 

  2322. 		$option_group = 'general';
    2323. 

  2323. 	}
    2324. 

  2324. 

  2325. 	if ( 'privacy' === $option_group ) {
    2326. 

  2326. 		_deprecated_argument(
    2327. 

  2327. 			__FUNCTION__,
    2328. 

  2328. 			'3.5.0',
    2329. 

  2329. 			sprintf(
    2330. 

  2330. 				/* translators: %s: privacy */
    2331. 

  2331. 				__( 'The "%s" options group has been removed. Use another settings group.' ),
    2332. 

  2332. 				'privacy'
    2333. 

  2333. 			)
    2334. 

  2334. 		);
    2335. 

  2335. 		$option_group = 'reading';
    2336. 

  2336. 	}
    2337. 

  2337. 

  2338. 	$new_allowed_options[ $option_group ][] = $option_name;
    2339. 

  2339. 

  2340. 	if ( ! empty( $args['sanitize_callback'] ) ) {
    2341. 

  2341. 		add_filter( "sanitize_option_{$option_name}", $args['sanitize_callback'] );
    2342. 

  2342. 	}
    2343. 

  2343. 	if ( array_key_exists( 'default', $args ) ) {
    2344. 

  2344. 		add_filter( "default_option_{$option_name}", 'filter_default_option', 10, 3 );
    2345. 

  2345. 	}
    2346. 

  2346. 

  2347. 	/**
    2348. 

  2348. 	 * Fires immediately before the setting is registered but after its filters are in place.
    2349. 

  2349. 	 *
    2350. 

  2350. 	 * @since 5.5.0
    2351. 

  2351. 	 *
    2352. 

  2352. 	 * @param string $option_group Setting group.
    2353. 

  2353. 	 * @param string $option_name  Setting name.
    2354. 

  2354. 	 * @param array  $args         Array of setting registration arguments.
    2355. 

  2355. 	 */
    2356. 

  2356. 	do_action( 'register_setting', $option_group, $option_name, $args );
    2357. 

  2357. 

  2358. 	$wp_registered_settings[ $option_name ] = $args;
    2359. 

  2359. }
    2360. 

  2360. 

  2361. /**
    2362. 

  2362.  * Unregisters a setting.
    2363. 

  2363.  *
    2364. 

  2364.  * @since 2.7.0
    2365. 

  2365.  * @since 4.7.0 `$sanitize_callback` was deprecated. The callback from `register_setting()` is now used instead.
    2366. 

  2366.  * @since 5.5.0 `$new_whitelist_options` was renamed to `$new_allowed_options`.
    2367. 

  2367.  *              Please consider writing more inclusive code.
    2368. 

  2368.  *
    2369. 

  2369.  * @global array $new_allowed_options
    2370. 

  2370.  * @global array $wp_registered_settings
    2371. 

  2371.  *
    2372. 

  2372.  * @param string          $option_group The settings group name used during registration.
    2373. 

  2373.  * @param string          $option_name  The name of the option to unregister.
    2374. 

  2374.  * @param callable|string $deprecated   Deprecated.
    2375. 

  2375.  */
    2376. 

  2376. function unregister_setting( $option_group, $option_name, $deprecated = '' ) {
    2377. 

  2377. 	global $new_allowed_options, $wp_registered_settings;
    2378. 

  2378. 

  2379. 	/*
    2380. 

  2380. 	 * In 5.5.0, the `$new_whitelist_options` global variable was renamed to `$new_allowed_options`.
    2381. 

  2381. 	 * Please consider writing more inclusive code.
    2382. 

  2382. 	 */
    2383. 

  2383. 	$GLOBALS['new_whitelist_options'] = &$new_allowed_options;
    2384. 

  2384. 

  2385. 	if ( 'misc' === $option_group ) {
    2386. 

  2386. 		_deprecated_argument(
    2387. 

  2387. 			__FUNCTION__,
    2388. 

  2388. 			'3.0.0',
    2389. 

  2389. 			sprintf(
    2390. 

  2390. 				/* translators: %s: misc */
    2391. 

  2391. 				__( 'The "%s" options group has been removed. Use another settings group.' ),
    2392. 

  2392. 				'misc'
    2393. 

  2393. 			)
    2394. 

  2394. 		);
    2395. 

  2395. 		$option_group = 'general';
    2396. 

  2396. 	}
    2397. 

  2397. 

  2398. 	if ( 'privacy' === $option_group ) {
    2399. 

  2399. 		_deprecated_argument(
    2400. 

  2400. 			__FUNCTION__,
    2401. 

  2401. 			'3.5.0',
    2402. 

  2402. 			sprintf(
    2403. 

  2403. 				/* translators: %s: privacy */
    2404. 

  2404. 				__( 'The "%s" options group has been removed. Use another settings group.' ),
    2405. 

  2405. 				'privacy'
    2406. 

  2406. 			)
    2407. 

  2407. 		);
    2408. 

  2408. 		$option_group = 'reading';
    2409. 

  2409. 	}
    2410. 

  2410. 

  2411. 	$pos = array_search( $option_name, (array) $new_allowed_options[ $option_group ], true );
    2412. 

  2412. 

  2413. 	if ( false !== $pos ) {
    2414. 

  2414. 		unset( $new_allowed_options[ $option_group ][ $pos ] );
    2415. 

  2415. 	}
    2416. 

  2416. 

  2417. 	if ( '' !== $deprecated ) {
    2418. 

  2418. 		_deprecated_argument(
    2419. 

  2419. 			__FUNCTION__,
    2420. 

  2420. 			'4.7.0',
    2421. 

  2421. 			sprintf(
    2422. 

  2422. 				/* translators: 1: $sanitize_callback, 2: register_setting() */
    2423. 

  2423. 				__( '%1$s is deprecated. The callback from %2$s is used instead.' ),
    2424. 

  2424. 				'<code>$sanitize_callback</code>',
    2425. 

  2425. 				'<code>register_setting()</code>'
    2426. 

  2426. 			)
    2427. 

  2427. 		);
    2428. 

  2428. 		remove_filter( "sanitize_option_{$option_name}", $deprecated );
    2429. 

  2429. 	}
    2430. 

  2430. 

  2431. 	if ( isset( $wp_registered_settings[ $option_name ] ) ) {
    2432. 

  2432. 		// Remove the sanitize callback if one was set during registration.
    2433. 

  2433. 		if ( ! empty( $wp_registered_settings[ $option_name ]['sanitize_callback'] ) ) {
    2434. 

  2434. 			remove_filter( "sanitize_option_{$option_name}", $wp_registered_settings[ $option_name ]['sanitize_callback'] );
    2435. 

  2435. 		}
    2436. 

  2436. 

  2437. 		// Remove the default filter if a default was provided during registration.
    2438. 

  2438. 		if ( array_key_exists( 'default', $wp_registered_settings[ $option_name ] ) ) {
    2439. 

  2439. 			remove_filter( "default_option_{$option_name}", 'filter_default_option', 10 );
    2440. 

  2440. 		}
    2441. 

  2441. 

  2442. 		/**
    2443. 

  2443. 		 * Fires immediately before the setting is unregistered and after its filters have been removed.
    2444. 

  2444. 		 *
    2445. 

  2445. 		 * @since 5.5.0
    2446. 

  2446. 		 *
    2447. 

  2447. 		 * @param string $option_group Setting group.
    2448. 

  2448. 		 * @param string $option_name  Setting name.
    2449. 

  2449. 		 */
    2450. 

  2450. 		do_action( 'unregister_setting', $option_group, $option_name );
    2451. 

  2451. 

  2452. 		unset( $wp_registered_settings[ $option_name ] );
    2453. 

  2453. 	}
    2454. 

  2454. }
    2455. 

  2455. 

  2456. /**
    2457. 

  2457.  * Retrieves an array of registered settings.
    2458. 

  2458.  *
    2459. 

  2459.  * @since 4.7.0
    2460. 

  2460.  *
    2461. 

  2461.  * @global array $wp_registered_settings
    2462. 

  2462.  *
    2463. 

  2463.  * @return array List of registered settings, keyed by option name.
    2464. 

  2464.  */
    2465. 

  2465. function get_registered_settings() {
    2466. 

  2466. 	global $wp_registered_settings;
    2467. 

  2467. 

  2468. 	if ( ! is_array( $wp_registered_settings ) ) {
    2469. 

  2469. 		return array();
    2470. 

  2470. 	}
    2471. 

  2471. 

  2472. 	return $wp_registered_settings;
    2473. 

  2473. }
    2474. 

  2474. 

  2475. /**
    2476. 

  2476.  * Filters the default value for the option.
    2477. 

  2477.  *
    2478. 

  2478.  * For settings which register a default setting in `register_setting()`, this
    2479. 

  2479.  * function is added as a filter to `default_option_{$option}`.
    2480. 

  2480.  *
    2481. 

  2481.  * @since 4.7.0
    2482. 

  2482.  *
    2483. 

  2483.  * @param mixed  $default        Existing default value to return.
    2484. 

  2484.  * @param string $option         Option name.
    2485. 

  2485.  * @param bool   $passed_default Was `get_option()` passed a default value?
    2486. 

  2486.  * @return mixed Filtered default value.
    2487. 

  2487.  */
    2488. 

  2488. function filter_default_option( $default, $option, $passed_default ) {
    2489. 

  2489. 	if ( $passed_default ) {
    2490. 

  2490. 		return $default;
    2491. 

  2491. 	}
    2492. 

  2492. 

  2493. 	$registered = get_registered_settings();
    2494. 

  2494. 	if ( empty( $registered[ $option ] ) ) {
    2495. 

  2495. 		return $default;
    2496. 

  2496. 	}
    2497. 

  2497. 

  2498. 	return $registered[ $option ]['default'];
    2499. 

  2499. }
    2500. 

  2500.