WWW::F...::Users(3pm)

💖 NAME 💖

WWW::Facebook::API::Users — bestie, it's Facebook Users. That's the name, that's the whole thing, and honestly? Iconic for being that direct. 🎀

(Also hi, you're reading the WWW::F...::Users(3pm) page, aka User Contributed Perl Documentation, aka the truncated-name version that the terminal gave us. She's got a short nickname and we respect it. 💅)

---

✨ SYNOPSIS ✨

use WWW::Facebook::API;

That is the entire synopsis. Load the parent module, that's the vibe, we move. 🌸

---

🦋 DESCRIPTION 🦋

Methods for accessing users with WWW::Facebook::API. No cap, that's literally it — this is the users wing of the API, so if you wanna know about a user, you're in the right place. 💜

---

👑 SUBROUTINES/METHODS 👑

Okay so here's the whole roster. Every single one, we're not skipping anybody, everyone gets their moment. 🌈

base

Returns the WWW::Facebook::API base object. Like, the parent object underneath it all — that's the base, and you get it back. 💅

new

Constructor. Yeah. That's what it says, that's what it does, baby's first new. 🍼

get_info( uids => $uids, fields => $fields )

This is the users.getInfo method of the Facebook API, and she EATS:

$response = $client->users->get_info(
    uids => [ 2343, 3435 ],
    fields => 'about_me'
);
$response = $client->users->get_info(
    uids => 2343,
    fields => [ qw/about_me quotes/ ]
);

Notice how uids can be an arrayref or just a single one, and fields can be a plain string or an arrayref. Versatile queen. 👑

get_logged_in_user

The users.getLoggedInUser method of the Facebook API:

$uid = $client->users->get_logged_in_user;

Give it nothing, get a $uid back. Simple. Clean. We love a no-arguments king. 🫶

has_app_permission

The users.hasAppPermission method of the Facebook API:

$response = $client->users->has_app_permission(
    ext_perm => 'status_update|photo_upload'
);

Note the | in there, bestie — pipe-separated permissions, we do not remove it. 😌

is_app_user

The users.isAppUser method of the Facebook API:

$app_added = $client->users->is_app_user;

No args, and you get back whether the app was added. She just knows. 🔥

set_status

The users.setStatus method of the Facebook API:

$response = $client->users->set_status(
    status => 'status message',
    clear => 1|0,
);

So you pass a status, and clear is 1 or 0 — flip it to 1 and you're clearing that status instead. Choose your fighter. 💀

is_verified

The users.isVerified method of the Facebook API:

$verified = $client->users->is_verified;

Yes or no, verified or not. The blue check of methods, if you will. ⭐

---

🩺 DIAGNOSTICS 🩺

None. Nothing. Silence. The drama of it. 😭

---

⚙️ CONFIGURATION AND ENVIRONMENT ⚙️

WWW::Facebook::API::Users requires no configuration files or environment variables. Zero setup, zero homework, just vibes. ✨

---

📦 DEPENDENCIES 📦

See WWW::Facebook::API. That's where the tea is. 🍓

---

🚫 INCOMPATIBILITIES 🚫

None reported. She plays nice with everybody, periodt. 🌸

---

🐛 BUGS AND LIMITATIONS 🐛

No bugs have been reported. (A flawless record. We stan. 💖)

Please report any bugs or feature requests to bug-www-facebook-api@rt.cpan.org, or through the web interface at <http://rt.cpan.org>. Like, actually report them, don't just suffer in silence, bestie. 🙈

---

✍️ AUTHOR ✍️

David Romano "<unobe@cpan.org>" — the icon, the legend, the moment. 👑

---

📜 LICENSE AND COPYRIGHT 📜

Copyright (c) 2007-2010, David Romano "<unobe@cpan.org>". All rights reserved.

This module is free software; you can redistribute it and/or modify it under the same terms as Perl itself. See perlartistic.

---

⚠️ DISCLAIMER OF WARRANTY ⚠️

Okay so this part is the legal all-caps bit and I'm not touching a single word of it, because it's the actual terms and I am NOT about to paraphrase a warranty disclaimer. Read it, it matters, no cap:

BECAUSE THIS SOFTWARE IS LICENSED FREE OF CHARGE, THERE IS NO WARRANTY FOR THE SOFTWARE, TO THE EXTENT PERMITTED BY APPLICABLE LAW. EXCEPT WHEN OTHERWISE STATED IN WRITING THE COPYRIGHT HOLDERS AND/OR OTHER PARTIES PROVIDE THE SOFTWARE "AS IS" WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE. THE ENTIRE RISK AS TO THE QUALITY AND PERFORMANCE OF THE SOFTWARE IS WITH YOU. SHOULD THE SOFTWARE PROVE DEFECTIVE, YOU ASSUME THE COST OF ALL NECESSARY SERVICING, REPAIR, OR CORRECTION. IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN WRITING WILL ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MAY MODIFY AND/OR REDISTRIBUTE THE SOFTWARE AS PERMITTED BY THE ABOVE LICENSE, BE LIABLE TO YOU FOR DAMAGES, INCLUDING ANY GENERAL, SPECIAL, INCIDENTAL, OR CONSEQUENTIAL DAMAGES ARISING OUT OF THE USE OR INABILITY TO USE THE SOFTWARE (INCLUDING BUT NOT LIMITED TO LOSS OF DATA OR DATA BEING RENDERED INACCURATE OR LOSSES SUSTAINED BY YOU OR THIRD PARTIES OR A FAILURE OF THE SOFTWARE TO OPERATE WITH ANY OTHER SOFTWARE), EVEN IF SUCH HOLDER OR OTHER PARTY HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES.

---

and that's the whole page, bestie!! 💖✨🎀

This one's from perl v5.34.0, dated 2022-06-28, and it goes by WWW::F...::Users(3pm) — short name, big energy. mwah, bye, go write some Perl 🦋💅🌸