હુક્સ સાથે કામ

હૂક પર કૉલબેક ફંક્શન કેવી રીતે નોંધણી કરવું તે જાણવા ઉપરાંત, વર્ડપ્રેસમાં હુક્સ સાથે કામ કરવા વિશે તમારે કેટલીક અન્ય બાબતો જાણવાની જરૂર છે.

આ પાઠમાં, તમે હૂક પ્રાધાન્યતા, હૂક પરિમાણો અને હૂક ઓર્ડર વિશે શીખી શકશો.

હૂક પ્રાધાન્યતા

ચાલો હૂક પ્રાધાન્યતા સાથે પ્રારંભ કરીએ.

જો તમે add_action માટેના દસ્તાવેજીકરણ પર એક નજર નાખશો તો તમને હૂક નામ અને કૉલબેક ફંક્શન પછી બે વધારાના ફંક્શન પરિમાણો દેખાશે.

ત્રીજું પરિમાણ હૂક પ્રાધાન્યતા છે, જે એક પૂર્ણાંક છે જે મૂળભૂત 10 છે. આનો અર્થ એ છે કે જો તમે તમારા કોડમાં કોઈ અગ્રતા નિર્દિષ્ટ કર્યા વિના કોઈ ક્રિયા નોંધણી કરો છો, તો તે 10 ની પ્રાથમિકતા સાથે નોંધવામાં આવશે.

add_filter ફંક્શનમાં પ્રાથમિકતા પરિમાણ પણ છે, જે તે જ રીતે કાર્ય કરે છે.

હૂક પ્રાધાન્યતા તમને વર્ડપ્રેસ કોર અથવા અન્ય થીમ્સ અથવા પ્લગિન્સ દ્વારા, આપેલ હૂક પર નોંધણી થઈ શકે તેવા કોઈપણ અન્ય હૂક કૉલબૅક્સની તુલનામાં, તમારું હૂક કૉલબેક ચલાવવામાં આવે છે તે ક્રમ નક્કી કરવાની મંજૂરી આપે છે.

હુક્સ પ્રાધાન્યતાના સંખ્યાત્મક ક્રમમાં ચાલે છે, 1 થી શરૂ થાય છે. સામાન્ય રીતે પ્રાથમિકતાને 10 ના મૂળભૂત પર છોડવી સલામત છે, સિવાય કે તમે તમારા કૉલબેક ફંક્શનને જે ક્રમમાં ચલાવવામાં આવે તે ક્રમમાં ફેરફાર કરવા માંગતા હો.

ઉદાહરણ તરીકે, ક્રિયા પાઠમાં after_setup_theme ઉદાહરણમાં, તમે ખાતરી કરી શકો છો કે રજિસ્ટર્ડ કૉલબૅક ફંક્શન વર્ડપ્રેસ કોર દ્વારા નોંધાયેલ કોઈપણ કૉલબૅક્સ ચલાવવામાં આવે તે પછી જ ચાલે છે.

કારણ કે વર્ડપ્રેસ કોર 10 ની મૂળભૂત અગ્રતા સાથે કોઈપણ હૂક કૉલબૅક્સની નોંધણી કરે છે, જો તમે 11 ની પ્રાથમિકતાનો ઉલ્લેખ કરો છો, તો તમે ખાતરી કરી શકો છો કે કોઈપણ કોર કૉલબૅક્સ પૂર્ણ થયા પછી મારું કૉલબૅક કાર્ય ચાલે છે.

add_action( 'after_setup_theme', 'wp_learn_setup_theme', 11 );

વૈકલ્પિક રીતે, જો તમે ખાતરી કરવા માંગતા હો કે કૉલબેક વર્ડપ્રેસ કોર પહેલા ચાલે છે, તો તમે નીચી અગ્રતા સેટ કરશો, કહો કે 9.

add_action( 'after_setup_theme', 'wp_learn_setup_theme', 9 );

ઘણીવાર તમે જોઈ શકો છો કે કૉલબૅક્સ ઉચ્ચ અગ્રતા સાથે નોંધાયેલ છે, જેમ કે 99 અથવા 9999.

add_action( 'after_setup_theme', 'wp_learn_setup_theme', 9999 );

આ એટલા માટે છે કારણ કે પ્લગઇન અથવા થીમ ડેવલપર ખાતરી કરવા માંગે છે કે આ કૉલબૅક અન્ય તમામ કૉલબૅક કાર્યો પછી ચલાવવામાં આવે છે. જો કે, અન્ય તૃતીય-પક્ષ પ્લગઈન્સ અથવા થીમ્સ તેમના કૉલબૅક્સને કઈ અગ્રતા પર મૂળભૂત કરી શકે છે તે ક્યારેય જાણી શકાતું નથી.

હૂક પરિમાણો

હવે ચાલો હૂક પરિમાણો જોઈએ,

add_action અને add_filter ફંક્શનમાં ચોથું પરિમાણ એ કૉલબેક ફંક્શન સ્વીકારી શકે તેવી સ્વીકૃત દલીલોની સંખ્યા છે.

https://developer.wordpress.org/reference/functions/add_filter/
https://developer.wordpress.org/reference/functions/add_action/

આ કેવી રીતે કાર્ય કરે છે તે વધુ સારી રીતે સમજવા માટે, ચાલો સામગ્રી-સંબંધિત ફિલ્ટર હૂક પર એક નજર કરીએ, get_the_excerpt.

ફિલ્ટર લાઇન 492 પર wp-includes/post-template.php ફાઇલમાં વ્યાખ્યાયિત થયેલ છે

return apply_filters( 'get_the_excerpt', $post->post_excerpt, $post );

આ ફિલ્ટરને get_the_excerpt ફંક્શનમાં વ્યાખ્યાયિત કરવામાં આવે છે, જેને બદલામાં the_excerpt ફંક્શનમાંથી બોલાવવામાં આવે છે.

આ ફંક્શનનો ઉપયોગ સામાન્ય રીતે શોધ પરિણામો પ્રદર્શિત કરતી વખતે થાય છે, જ્યાં તે પોસ્ટના અંશો બતાવવા માટે ઉપયોગી છે અને પોસ્ટ સામગ્રીને નહીં.

apply_filters ફંક્શન ફિલ્ટર હૂકને બે વેરીએબલ સાથે નોંધણી કરી રહ્યું છે જે ફિલ્ટર સાથે સંકળાયેલ છે, $post_excerpt સ્ટ્રિંગ વેરીએબલ અને $post ઑબ્જેક્ટ.

ક્રિયા અથવા ફિલ્ટર હૂકને વ્યાખ્યાયિત કરતી વખતે, કોઈપણ સંખ્યામાં સંભવિત દલીલો ઉમેરી શકાય છે. જો કે, સ્વીકૃત દલીલો પરિમાણને પસાર કરવામાં આવેલ નંબર નક્કી કરે છે કે તેમાંથી કેટલા હૂક કૉલબેક ફંક્શનમાં પાસ થયા છે.

જો તમે add_filter માટેના દસ્તાવેજો જોશો તો તમને સ્વીકૃત દલીલોની સંખ્યા માટે મૂળભૂત મૂલ્ય 1 દેખાશે, જેનો અર્થ છે કે જો તમે આ પરિમાણ માટે કોઈ મૂલ્ય નિર્દિષ્ટ કરશો નહીં, તો પ્રથમ દલીલ કૉલબૅક ફંક્શનમાં પસાર કરવા માટે ઉપલબ્ધ હશે.

get_the_excerpt ફિલ્ટરમાં, સ્વીકારવા માટે બે સંભવિત ચલો છે.

જો તમે દલીલોની સંખ્યા સુયોજિત કર્યા વિના કૉલબૅકની નોંધણી કરાવો છો, તો કૉલબૅક ફંક્શનમાં ફક્ત પ્રથમ જ ઉપલબ્ધ હશે, આ કિસ્સામાં, post_excerpt.

add_filter( 'get_the_excerpt', 'wp_learn_amend_the_excerpt', 10 );
function wp_learn_amend_the_excerpt( $post_excerpt ) {
    // do something with the $post_excerpt
}

વધુ ઉપલબ્ધ દલીલો સ્વીકારવા માટે, તમારે સ્વીકારવા માટેની દલીલોની સંખ્યા સ્પષ્ટ કરવાની જરૂર છે.

add_filter( 'get_the_excerpt', 'wp_learn_amend_the_excerpt', 10, 2 );

પછી તમે તમારા કૉલબેક કાર્યમાં તે દલીલોનો ઉપયોગ કરી શકો છો

function wp_learn_amend_the_excerpt( $post_excerpt, $post ) {

}

તમારા કૉલબેક કાર્ય માટે તમારે કઈ દલીલોની જરૂર છે તે નિર્ધારિત કરવામાં સક્ષમ બનવું અને હૂક નોંધણીમાં નંબર સેટ કરવો એ એક મૂલ્યવાન કૌશલ્ય છે.

ઉદાહરણ તરીકે, ચાલો કહીએ કે તમે ટૂંકસાર પછી ટેક્સ્ટનો એક સરળ ભાગ ઉમેરવા માગો છો. તે કિસ્સામાં, તમારે માત્ર $post_excerptની જરૂર પડશે, જેથી તમે સ્વીકૃત દલીલો સેટિંગ છોડી શકો.

add_filter( 'get_the_excerpt', 'wp_learn_amend_the_excerpt', 11 );
function wp_learn_amend_the_excerpt( $post_excerpt ) {
    $additional_content = '<p>Verified by Search Engine</p>';
    $post_excerpt       = $post_excerpt . $additional_content;

    return $post_excerpt;
}

નોંધ લો કે કેવી રીતે પ્રાથમિકતા પણ અપડેટ કરવામાં આવી છે. તમે આ કરી શકો છો કારણ કે તમે ખાતરી કરવા માંગો છો કે આ ફિલ્ટરને સોંપેલ કોઈપણ કોર ફિલ્ટર કૉલબૅક્સ ચલાવવામાં આવ્યા પછી આ ટેક્સ્ટમાં સુધારો કરવામાં આવ્યો છે.

ચાલો અમારા શોધ પરિણામોમાં તેના પર એક નજર કરીએ.

જો કે, જો તમે પોસ્ટમાંથી કંઈક શામેલ કરવા માંગતા હો, તો પોસ્ટનું શીર્ષક કહો?

આ કિસ્સામાં, તમે $post ઑબ્જેક્ટમાંથી પોસ્ટ શીર્ષક મેળવવા માટે હૂકમાંથી બંને દલીલો સ્વીકારવા માટે તમારા કૉલબેકને અપડેટ કરશો.

add_filter( 'get_the_excerpt', 'wp_learn_amend_the_excerpt', 11, 2 );
function wp_learn_amend_the_excerpt( $post_excerpt, $post ) {
    $additional_content = '<p>'. $post->post_title . ' Verified by Search Engine</p>';
    $post_excerpt       = $post_excerpt . $additional_content;

    return $post_excerpt;
}

ચાલો જોઈએ કે અમારા અપડેટ કરેલા શોધ પરિણામોમાં આ કેવું દેખાય છે.

તમે જોશો કે આ કોડ કૉલબેકમાં પસાર થતી દલીલો માટે સમાન ચલ નામોનો ઉપયોગ કરી રહ્યો છે, આ કિસ્સામાં, $post_excerpt અને $post.

આ કોઈ આવશ્યકતા નથી, અને જ્યારે તમે તમારા કૉલબેક ફંક્શનને નોંધણી કરો

ત્યારે તમે તેમને ગમે તે રીતે કૉલ કરી શકો છો, પરંતુ જો તમે તેમને સમાન નામ આપો તો દરેક વેરીએબલ શેના માટે છે તે યાદ રાખવું સરળ બનાવે છે.

હૂક ઓર્ડર

તમારી ચોક્કસ જરૂરિયાતો પર આધાર રાખીને, તમારે પહેલા તે નક્કી કરવાની જરૂર પડી શકે છે કે કઈ ક્રિયા અથવા ફિલ્ટરનો ઉપયોગ કરવો યોગ્ય છે.

સદનસીબે, વર્ડપ્રેસ ડેવલપર ડોક્યુમેન્ટેશનમાં કોમન APIs વિભાગમાં હુક્સ પર એક પેજ છે, જેમાં તમામ ક્રિયા અને ફિલ્ટર હુક્સની સૂચિ છે અને તે ક્રમમાં વર્ડપ્રેસ સાઇટ પર વિવિધ વિનંતીઓ દરમિયાન ચલાવવામાં આવે છે.

તમે જે હૂકનો ઉપયોગ કરવા માંગો છો તે ક્યારે ચલાવવામાં આવે છે તે તપાસવા માટે તમે આ સૂચિનો ઉપયોગ કરી શકો છો અને પછી તે તમારી જરૂરિયાતો માટે યોગ્ય હૂક છે કે કેમ તે નિર્ધારિત કરવા માટે આ માહિતીનો ઉપયોગ કરી શકો છો.