طدُه<hرُه<بزُه<(شُه<@àُ[و<~a@ِ[و<€a@ًà[و<€a€aPذُه<8ذُه<پ€ahذُه<ّذُه<Pرُه<@ذ\و<پaپƒaƒa {قه<°ذُه<@ ِ[و<„a@@ِ[و<„a„a(رُه<„a¸{قه<رُه<€aذ{قه< ذُه<@`ِ[و<†a@€ِ[و<ˆa@(ذ\و<ˆaˆa°رُه<کرُه<پˆaبرُه<Xزُه<°زُه<@Pذ\و<‰aپ‹a‹aè{قه<زُه<@ ِ[و<Œa@ہِ[و<ŒaŒaˆزُه<Œa|قه<pزُه<ˆa|قه<€رُه<@àِ[و<ژa@÷[و<گa@ ل[و<گaگaسُه<ّزُه<پگa(سُه<¸سُه<شُه<@xذ\و<‘aپ“a“a0|قه<pسُه<@ ÷[و<”a@@÷[و<”a”aèسُه<”aH|قه<ذسُه<گa`|قه<àزُه<@`÷[و<–a@€÷[و<کa@ ذ\و<کaکapشُه<Xشُه<پکaˆشُه<صُه<pصُه<@بذ\و<™aپ›a›ax|قه<ذشُه<@ ÷[و<œa@ہ÷[و<œaœaHصُه<œaگ|قه<0صُه<کa¨|قه<@شُه<پxaطدُه<hرُه<بزُه<(شُه<ˆصُه<8×ُه<àطُه<@عُه<@à÷[و<‍a@ّ[و< a@ًذ\و< a a ضُه<ضُه<پ a8ضُه<بضُه< ×ُه<@ر\و<،aپ£a£aہ|قه<€ضُه<@ ّ[و<¤a@@ّ[و<¤a¤aّضُه<¤aط|قه<àضُه< aً|قه<ًصُه<@`ّ[و<¦a@€ّ[و<¨a@Pل[و<¨a¨a€×ُه<h×ُه<پ¨aک×ُه<pطُه<بطُه<@@ر\و<©a@«a@€ل[و<«a«aطُه<ّ×ُه<پ«a(طُه<«a}قه<à×ُه<@ ّ[و<a@ہّ[و<aa طُه<a }قه<ˆطُه<¨a8}قه<P×ُه<@àّ[و<¯a@ù[و<±a@hر\و<±a±a(ظُه<ظُه<پ±a@ظُه<ذظُه<(عُه<@گر\و<²aپ´a´aP}قه<ˆظُه<@ ù[و<µa@@ù[و<µaµaعُه<µah}قه<èظُه<±a€}قه<ّطُه<@`ù[و<·a@€ù[و<¹a@¸ر\و<¹a¹aˆعُه<pعُه<پ¹a عُه<0غُه<ˆغُه<@àر\و<؛aپ¼a¼aک}قه<èعُه<@ ù[و<½a@ہù[و<½a½a`غُه<½a°}قه<Hغُه<¹aب}قه<Xعُه<پxaطدُه<hرُه<بزُه<(شُه<ˆصُه<8×ُه<àطُه<@عُه< غُه<گفُه<8كُه<کàُه<ّلُه<Xمُه<هُه<¨وُه<@àù[و<؟a@ْ[و<ءa@ز\و<ءaءaxـُه<`ـُه<پءaگـُه< فُه<xفُه<@0ز\و<آaپؤaؤaà}قه<طـُه<@ ْ[و<إa@@ْ[و<إaإaPفُه<إaّ}قه<8فُه<ءa~قه<Hـُه<@`ْ[و<اa@€ْ[و<ةa@Xز\و<ةaةaطفُه<ہفُه<پةaًفُه<بقُه< كُه<@€ز\و<تa@جa@ ْ[و<جaجahقُه<Pقُه<پجa€قُه<جa(~قه<8قُه<@ہْ[و<خa@àْ[و<خaخaّقُه<خa@~قه<àقُه<ةaX~قه<¨فُه<@û[و<ذa@ û[و<زa@¨ز\و<زaزa€كُه<hكُه<پزaکكُه<(àُه<€àُه<@ذز\و<سaپصa * * @since 5.0.6 * * @param mixed $value If anything diff than null it will short-circuit. * @param string $key Key for the option we are trying to get. * @param mixed $default Default value when the option is either expired or not-set. * @param bool $force If we should expire cache and fetch from the database. * @param bool $cache If the value was pulled from cache. */ return apply_filters( 'tec_common_timed_option_value', $this->data[ $key ]['value'], $key, $default, $force, true ); } $timed_option = null; if ( $this->is_active() ) { $timed_option_name = $this->get_option_name( $key ); if ( true === $force ) { wp_cache_delete( $timed_option_name, 'options' ); } $timed_option = get_option( $timed_option_name, null ); } // Bail with default when non-existent. if ( empty( $timed_option ) ) { if ( $this->is_active() ) { // Avoids next request check, forces auto-loading. $this->set( $key, null, 0 ); } return $default; } // Bail with default when expired. if ( $time >= $timed_option['expiration'] ) { $this->delete( $key ); return $default; } $this->data[ $key ] = $timed_option; /** * Allows the filtering of the value of the timed option. * * @since 5.0.6 * * @param mixed $value If anything diff than null it will short-circuit. * @param string $key Key for the option we are trying to get. * @param mixed $default Default value when the option is either expired or not-set. * @param bool $force If we should expire cache and fetch from the database. * @param bool $cache If the value was pulled from cache. */ return apply_filters( 'tec_common_timed_option_value', $timed_option['value'], $key, $default, $force, false ); } /** * Delete a given timed option based on a key. * Will also clear local cache. * * @since 5.0.6 * * @param string $key Which timed option we are checking. * * @return bool */ public function delete( $key ): bool { $key = (string) $key; $updated = false; if ( $this->is_active() ) { $timed_option_name = $this->get_option_name( $key ); $updated = update_option( $timed_option_name, null, true ); wp_cache_delete( $timed_option_name, 'options' ); } // Bail with default when non-existent. if ( ! isset( $this->data[ $key ] ) ) { return $updated; } unset( $this->data[ $key ] ); return $updated; } /** * Checks if a given timed option exists. * * @since 5.0.6 * * @param string $key Which timed option we are checking. * @param bool $force Clears the cache before get_option() * * @return bool */ public function exists( $key, bool $force = false ): bool { /** * Allows the filtering to short-circuit the whole exists logic. * * @since 5.0.6 * * @param mixed|null $pre If anything diff than null it will short-circuit. * @param string $key Key for the option we are trying to get. * @param bool $force If we should expire cache and fetch from the database. */ $pre = apply_filters( 'tec_common_timed_option_pre_exists', null, $key, $force ); if ( null !== $pre ) { return (bool) $pre; } $time = time(); $cached = false; $timed_option = null; // If we have a stored value that is not expired, use it. if ( ! $force && isset( $this->data[ $key ] ) && is_numeric( $this->data[ $key ]['expiration'] ) && $time < $this->data[ $key ]['expiration'] ) { $cached = true; $timed_option = $this->data[ $key ]; } elseif ( $this->is_active() ) { $timed_option_name = $this->get_option_name( $key ); if ( true === $force ) { wp_cache_delete( $timed_option_name, 'options' ); } $timed_option = get_option( $timed_option_name, null ); } $exists = true; if ( null === $timed_option ) { $exists = false; } if ( ! is_array( $timed_option ) ) { $exists = false; } if ( ! isset( $timed_option['expiration'] ) || ! is_numeric( $timed_option['expiration'] ) ) { $exists = false; } /** * Does a particular timed option key exists. * * @since 5.0.6 * * @param mixed $exists If anything diff than null it will short-circuit. * @param string $key Key for the option we are trying to get. * @param bool $force If we should expire cache and fetch from the database. * @param bool $cached If the value was pulled from cache. */ return (bool) apply_filters( 'tec_common_timed_option_exists', $exists, $key, $force, $cached ); } /** * Update the value of a timed option on the database and on local cache. * * @since 5.0.6 * * @param string $key Key for this option. * @param mixed $value Value stored for this option. * @param int $expiration Expiration in seconds for this timed option. * * @return bool */ public function set( $key, $value, int $expiration = DAY_IN_SECONDS ): bool { $key = (string) $key; $data = [ 'key' => $key, 'value' => $value, 'expiration' => time() + $expiration, ]; $this->data[ $key ] = $data; $updated = true; if ( $this->is_active() ) { $updated = update_option( $this->get_option_name( $key ), $data, true ); } return $updated; } }