Skip to Content
Menu

facebook_share()

Create a native Facebook share button.

PHP March 16, 2017

Usage

PHP
nebula()->facebook_share($counts, $url)

Parameters

$counts
(Optional) (Boolean) Whether to show count bubble
Default: false

$url
(Optional) (String) The URL to share
Default: (Current page URL)

Request or provide clarification »

Examples

Only show count bubbles to staff.

PHP
<?php nebula()->facebook_share(nebula()->is_staff()); ?>
Was this page helpful? Yes No


    A feedback message is required to submit this form.


    Please check that you have entered a valid email address.

    Enter your email address if you would like a response.

    Thank you for your feedback!

    Source File

    Located in /libs/Functions.php on line 1147.

    1 Hook

    Find these filters and actions in the source code below to hook into them. Use do_action() and add_filter() in your functions file or plugin.

    Filters
    "pre_nebula_facebook_share"
    Need a new filter hook? Request one here.

    Actions
    This function has no action hooks available. Request one?

    PHP
            public function facebook_share($counts=0, $url=false){
                $override = apply_filters('pre_nebula_facebook_share', null, $counts);
                if ( isset($override) ){return;}
                ?>
                <div class="nebula-social-button facebook-share require-fbsdk">
                    <div class="fb-share-button" data-href="<?php echo ( !empty($url) )? $url : get_page_link(); ?>" data-layout="<?php echo ( $counts !== 0 )? 'button_count' : 'button'; ?>" data-size="small" data-mobile-iframe="true"></div>
                </div>
            <?php }
    

    Override

    To override this PHP function, use this hook in your child theme or plugin ("my_custom" can be changed):

    PHP
    add_filter('pre_nebula_facebook_share', 'my_custom_facebook_share', 10, 3); //The last integer must be 1 more than the actual parameters
    function my_custom_facebook_share($null, $counts, $url){ //$null is required, but can be ignored
        //Write your own code here
    
        return true; //Return true to prevent the original function from running afterwords
    }

    You can completely disable this PHP function with a single line actions:

    PHP
     add_filter('pre_nebula_facebook_share', '__return_false');