The Red Matrix
 All Classes Namespaces Files Functions Variables Pages
text.php File Reference

Functions

 replace_macros ($s, $r)
 
 random_string ($size=64, $type=RANDOM_STRING_HEX)
 
 notags ($string)
 
 escape_tags ($string)
 
 z_input_filter ($channel_id, $s, $type= 'text/bbcode')
 
 purify_html ($s)
 
 autoname ($len)
 
 xmlify ($str)
 
 unxmlify ($s)
 
if(!function_exists('hex2bin')) paginate (&$a)
 
 alt_pager (&$a, $i, $more= '', $less= '')
 
 expand_acl ($s)
 
 sanitise_acl (&$item)
 
 perms2str ($p)
 
 item_message_id ()
 Generate a guaranteed unique (for this domain) item ID for ATOM. More...
 
 photo_new_resource ()
 Generate a guaranteed unique photo ID. More...
 
 attribute_contains ($attr, $s)
 
 logger ($msg, $level=0)
 Logging function for RedMatrix. More...
 
 dlogger ($msg, $level=0)
 This is a special logging facility for developers. More...
 
 profiler ($t1, $t2, $label)
 
 activity_match ($haystack, $needle)
 
 get_tags ($s)
 
 tag_sort_length ($a, $b)
 
 strip_zids ($s)
 
 qp ($s)
 
 get_mentions ($item, $tags)
 
 contact_block ()
 
 chanlink_hash ($s)
 
 chanlink_url ($s)
 
 chanlink_cid ($d)
 
 magiclink_url ($observer, $myaddr, $url)
 
 micropro ($contact, $redirect=false, $class= '', $textmode=false)
 
 search ($s, $id='search-box', $url='/search', $save=false)
 
 searchbox ($s, $id='search-box', $url='/search', $save=false)
 
 valid_email ($x)
 
 linkify ($s, $me=false)
 
 sslify ($s)
 
 get_poke_verbs ()
 
 get_mood_verbs ()
 
 list_smilies ()
 
 smilies ($s, $sample=false)
 
 smile_shield ($m)
 
 smile_unshield ($m)
 
 preg_heart ($x)
 
 day_translate ($s)
 
 normalise_link ($url)
 
 link_compare ($a, $b)
 
 unobscure (&$item)
 
 theme_attachments (&$item)
 
 format_categories (&$item, $writeable)
 
 format_hashtags (&$item)
 
 format_mentions (&$item)
 
 format_filer (&$item)
 
 generate_map ($coord)
 
 generate_named_map ($location)
 
 prepare_body (&$item, $attach=false)
 
 prepare_text ($text, $content_type= 'text/bbcode')
 
 zidify_callback ($match)
 
 zidify_img_callback ($match)
 
 zidify_links ($s)
 
 feed_hublinks ()
 
 feed_salmonlinks ($nick)
 
 get_plink ($item, $conversation_mode=true)
 
 unamp ($s)
 
 layout_select ($channel_id, $current= '')
 
 mimetype_select ($channel_id, $current= 'text/bbcode')
 
 lang_selector ()
 
 return_bytes ($size_str)
 
 base64url_encode ($s, $strip_padding=true)
 
 base64url_decode ($s)
 
 cleardiv ()
 
 bb_translate_video ($s)
 
 html2bb_video ($s)
 
 array_xmlify ($val)
 
 reltoabs ($text, $base)
 
 item_post_type ($item)
 
 undo_post_tagging ($s)
 
 fix_mce_lf ($s)
 
 protect_sprintf ($s)
 
 is_a_date_arg ($s)
 
 legal_webbie ($s)
 
 check_webbie ($arr)
 
 ids_to_querystr ($arr, $idx= 'id')
 
 xchan_query (&$items, $abook=true, $effective_uid=0)
 
 xchan_mail_query (&$item)
 
 find_xchan_in_array ($xchan, $arr)
 
 get_rel_link ($j, $rel)
 
 magic_link ($s)
 
 stringify_array_elms (&$arr, $escape=false)
 
 jindent ($json)
 
 json_decode_plus ($s)
 
 design_tools ()
 
 in_arrayi ($needle, $haystack)
 
 normalise_openid ($s)
 
 extra_query_args ()
 
 handle_tag ($a, &$body, &$access_tag, &$str_tags, $profile_uid, $tag)
 
 linkify_tags ($a, &$body, $uid)
 
 getIconFromType ($type)
 returns icon name for use with e.g. font-awesome based on mime-type More...
 
 userReadableSize ($size)
 Returns a human readable formatted string for filesizes. More...
 

Variables

const RANDOM_STRING_HEX 0x00
 
const RANDOM_STRING_TEXT 0x01
 

Function Documentation

alt_pager ( $a,
  $i,
  $more = '',
  $less = '' 
)
array_xmlify (   $val)

apply xmlify() to all values of array $val, recursively

Referenced by api_apply_template(), and poco().

attribute_contains (   $attr,
  $s 
)

Referenced by scrape_vcard().

autoname (   $len)

generate a string that's random, but usually pronounceable. used to generate initial passwords

Parameters
int$len
Returns
string

Referenced by check_php(), invite_post(), and lostpass_content().

bb_translate_video (   $s)

Referenced by item_post().

chanlink_cid (   $d)

Referenced by connedit_content().

chanlink_hash (   $s)
check_webbie (   $arr)
cleardiv ( )

@ Return a div to clear floats.

Returns
string

Referenced by common_content(), and match_content().

contact_block ( )

Referenced by profile_sidebar().

design_tools ( )

Referenced by widget_design_tools().

dlogger (   $msg,
  $level = 0 
)

This is a special logging facility for developers.

It allows one to target specific things to trace/debug and is identical to logger() with the exception of the log filename. This allows one to isolate specific calls while allowing logger() to paint a bigger picture of overall activity and capture more detail.

If you find dlogger() calls in checked in code, you are free to remove them - so as to provide a noise-free development environment which responds to events you are targetting personally.

Parameters
string$msgMessage to log
int$levelA log level.
extra_query_args ( )
feed_hublinks ( )

return atom link elements for all of our hubs

feed_salmonlinks (   $nick)
fix_mce_lf (   $s)

Referenced by profiles_post().

format_categories ( $item,
  $writeable 
)

Referenced by prepare_body().

format_filer ( $item)

Referenced by prepare_body().

format_hashtags ( $item)

Referenced by prepare_body().

format_mentions ( $item)

Referenced by prepare_body().

generate_map (   $coord)

Referenced by bb_map_coords(), and prepare_body().

generate_named_map (   $location)

Referenced by bb_map_location().

get_mentions (   $item,
  $tags 
)
get_mood_verbs ( )

Referenced by mood_content(), and mood_init().

get_plink (   $item,
  $conversation_mode = true 
)
get_poke_verbs ( )

Referenced by poke_content(), and poke_init().

get_rel_link (   $j,
  $rel 
)
get_tags (   $s)

Referenced by linkify_tags().

getIconFromType (   $type)

returns icon name for use with e.g. font-awesome based on mime-type

Parameters
string$type
Returns
string

Referenced by RedMatrix\RedDAV\RedBrowser\generateDirectoryIndex(), and sharedwithme_content().

handle_tag (   $a,
$body,
$access_tag,
$str_tags,
  $profile_uid,
  $tag 
)

This function removes the tag $tag from the text $body and replaces it with the appropiate link.

Parameters
unknown_type$bodythe text to replace the tag in
unknown_type$access_tag- used to return tag ACL exclusions e.g. @!foo
unknown_type$str_tagsstring to add the tag to
unknown_type$profile_uid
unknown_type$tagthe tag to replace
Returns
boolean true if replaced, false if not replaced

Referenced by linkify_tags().

html2bb_video (   $s)
ids_to_querystr (   $arr,
  $idx = 'id' 
)
in_arrayi (   $needle,
  $haystack 
)
is_a_date_arg (   $s)

Referenced by channel_content(), and network_content().

item_message_id ( )

Generate a guaranteed unique (for this domain) item ID for ATOM.

Safe from birthday paradox.

Returns
string a unique id

Referenced by event_store_item(), file_activity(), impel_init(), item_post(), like_content(), mood_init(), photo_upload(), photos_create_item(), post_activity_item(), profile_activity(), and subthread_content().

item_post_type (   $item)

Referenced by notification().

jindent (   $json)

Indents a flat JSON string to make it more human-readable.

Parameters
string$jsonThe original JSON string to process.
Returns
string Indented version of the original JSON string.
lang_selector ( )

Referenced by lang_content().

layout_select (   $channel_id,
  $current = '' 
)

Referenced by editwebpage_content().

legal_webbie (   $s)

Referenced by check_webbie(), and new_channel_init().

link_compare (   $a,
  $b 
)

Compare two URLs to see if they are the same, but ignore slight but hopefully insignificant differences such as if one is https and the other isn't, or if one is www.something and the other isn't - and also ignore case differences.

Return true if the URLs match, otherwise false.

Referenced by consume_feed(), diaspora_retraction(), pubsub_init(), pubsubhubbub_init(), tag_deliver(), tgroup_check(), and zid().

linkify (   $s,
  $me = false 
)

Function: linkify

Replace naked text hyperlink with HTML formatted hyperlink

Referenced by advanced_profile(), directory_content(), and profile_sidebar().

list_smilies ( )

Referenced by smilies(), and smilies_content().

logger (   $msg,
  $level = 0 
)

Logging function for RedMatrix.

Logging output is configured through RedMatrix's system config. The log file is set in system logfile, log level in system loglevel and to enable logging set system debugging.

Available constants for log level are LOGGER_NORMAL, LOGGER_TRACE, LOGGER_DEBUG, LOGGER_DATA and LOGGER_ALL.

Since PHP5.4 we get the file, function and line automatically where the logger was caleld, so no need to add it to the message anymore.

Parameters
string$msgMessage to log
int$levelA log level.

Referenced by account_remove(), account_verify_password(), Item\add_child(), Conversation\add_thread(), admin_content(), admin_page_hubloc_post(), admin_post(), aes_encapsulate(), allowed_public_recips(), api_call(), api_channel_stream(), api_export_basic(), api_favorites(), api_get_user(), api_login(), api_oauth_request_token(), api_statuses_destroy(), api_statuses_mediap(), api_statuses_repeat(), api_statuses_show(), api_statuses_update(), api_statuses_user_timeline(), attach_mkdir(), avatar_img(), base64url_decode(), bb2diaspora_itembody(), bb2diaspora_itemwallwall(), bookmark_add(), bookmarks_init(), build_sync_packet(), channel_remove(), chanview_content(), chat_post(), check_config(), check_form_security_token_ForbiddenOnErr(), check_form_security_token_redirectOnErr(), cloud_init(), connedit_post(), consume_feed(), contact_remove(), conversation(), create_account(), create_identity(), RedMatrix\RedDAV\RedDirectory\createDirectory(), RedMatrix\RedDAV\RedDirectory\createFile(), cronhooks_run(), datetime_convert(), dav_init(), RedMatrix\RedDAV\RedFile\delete(), delete_imported_item(), deliver_run(), detect_language(), diaspora_asphoto(), diaspora_comment(), diaspora_conversation(), diaspora_decode(), diaspora_dispatch(), diaspora_dispatch_public(), diaspora_handle_from_contact(), diaspora_is_blacklisted(), diaspora_like(), diaspora_message(), diaspora_msg_build(), diaspora_photo(), diaspora_post(), diaspora_process_outbound(), diaspora_profile(), diaspora_pubmsg_build(), diaspora_request(), diaspora_reshare(), diaspora_send_followup(), diaspora_send_images(), diaspora_send_mail(), diaspora_send_relay(), diaspora_send_status(), diaspora_share(), diaspora_signed_retraction(), diaspora_transmit(), dir_parse_query(), directory_content(), directory_run(), discover_by_url(), discover_by_webbie(), downgrade_accounts(), email_send(), encode_item(), events_post(), expire_run(), externals_run(), feed_init(), fetch_lrdd_template(), fetch_xrd_links(), filer_content(), filerm_content(), find_diaspora_person_by_handle(), fix_private_photos(), fix_system_urls(), RedMatrix\RedDAV\RedFile\get(), get_atom_elements(), get_diaspora_key(), get_diaspora_reshare_xml(), get_item_elements(), Conversation\get_template_data(), RedMatrix\RedDAV\RedDirectory\getChild(), RedMatrix\RedDAV\RedDirectory\getDir(), group_content(), guess_image_type(), http_status_exit(), hubloc_change_primary(), impel_init(), import_author_rss(), import_author_unknown(), import_author_zot(), import_channel_photo(), import_directory_profile(), import_post(), import_profile_photo(), import_site(), import_xchan(), install_plugin(), item_post(), item_store(), item_store_update(), like_content(), limit_body_size(), load_plugin(), local_dir_update(), local_user(), localize_item(), RedMatrix\RedDAV\RedDirectory\log(), RedMatrix\RedDAV\RedBasicAuth\log(), FKOAuth1\loginUser(), FKOAuthDataStore\lookup_consumer(), FKOAuthDataStore\lookup_token(), magic_init(), mail_post(), mail_store(), menu_edit(), mini_group_select(), mood_init(), FKOAuthDataStore\new_access_token(), new_contact(), new_keypair(), FKOAuthDataStore\new_request_token(), notes_init(), notification(), notifier_run(), old_webfinger(), onedirsync_run(), onepoll_run(), openid_content(), parse_url_content(), parse_xml_string(), photo_init(), photo_upload(), photos_content(), photos_post(), ping_init(), poco(), poco_load(), poke_init(), poller_run(), post_activity_item(), post_init(), post_post(), process_channel_sync_delivery(), process_delivery(), process_location_delivery(), process_mail_delivery(), process_profile_delivery(), process_rating_delivery(), profile_load(), profile_photo_set_profile_perms(), profile_sidebar(), prune_hub_reinstalls(), public_recips(), pubsub_init(), pubsub_post(), pubsubhubbub_init(), RedMatrix\RedDAV\RedFile\put(), dba_mysql\q(), dba_mysqli\q(), dba_postgres\q(), queue_run(), random_profile(), ratenotif_run(), rbmark_post(), receive_post(), red_item_new(), RedChannelList(), RedCollectionData(), RedFileData(), register_content(), reload_plugins(), remote_user(), Item\remove_child(), remove_community_tag(), remove_obsolete_hublocs(), remove_queue_item(), scale_external_images(), scrape_feed(), scrape_vcard(), search_ac_init(), enotify\send(), send_reg_approval_email(), set_linkified_perms(), Conversation\set_mode(), RedMatrix\RedDAV\RedFile\setName(), RedMatrix\RedDAV\RedDirectory\setName(), settings_post(), start_delivery_chain(), store_diaspora_comment_sig(), stream_perms_api_uids(), stream_perms_xchans(), subthread_content(), sync_directories(), sync_locations(), tag_deliver(), tagger_content(), tgroup_check(), uninstall_plugin(), unload_plugin(), update_directory_entry(), update_feed_item(), update_imported_item(), update_queue_time(), RedMatrix\RedDAV\RedBasicAuth\validateUserPass(), verify_email_address(), xml2array(), xml_status(), z_fetch_url(), z_post_url(), zfinger_init(), zid_init(), zot_build_packet(), zot_feed(), zot_fetch(), zot_finger(), zot_gethub(), zot_import(), zot_process_message_request(), zot_process_response(), zot_refresh(), zot_register_hub(), and zotfeed_init().

magic_link (   $s)
magiclink_url (   $observer,
  $myaddr,
  $url 
)
micropro (   $contact,
  $redirect = false,
  $class = '',
  $textmode = false 
)

Referenced by contact_block().

mimetype_select (   $channel_id,
  $current = 'text/bbcode' 
)
normalise_openid (   $s)

Referenced by openid_content().

notags (   $string)

This is our primary input filter.

The high bit hack only involved some old IE browser, forget which (IE5/Mac?) that had an XSS attack vector due to stripping the high-bit on an 8-bit character after cleansing, and angle chars with the high bit set could get through as markup.

This is now disabled because it was interfering with some legitimate unicode sequences and hopefully there aren't a lot of those browsers left.

Use this on any text input where angle chars are not valid or permitted They will be replaced with safer brackets. This may be filtered further if these are not allowed either.

Parameters
string$stringInput string
Returns
string Filtered string

Referenced by admin_page_logs_post(), admin_page_site_post(), channel_content(), connections_content(), conversation(), create_account(), diaspora_asphoto(), diaspora_comment(), diaspora_conversation(), diaspora_like(), diaspora_message(), diaspora_photo(), diaspora_post(), diaspora_profile(), diaspora_reshare(), diaspora_retraction(), diaspora_signed_retraction(), directory_content(), discover_by_url(), filestorage_post(), follow_init(), get_atom_elements(), get_diaspora_reshare_xml(), group_post(), help_content(), invite_post(), item_post(), item_store(), item_store_update(), like_content(), lostpass_post(), mail_post(), mail_store(), mood_init(), network_content(), oexchange_content(), openid_content(), photos_post(), poco(), poke_init(), post_var(), profiles_post(), pubsub_init(), pubsub_post(), register_post(), sanitise_acl(), settings_post(), setup_content(), setup_post(), subthread_content(), tagger_content(), and xrd_init().

if (!function_exists('hex2bin')) paginate ( $a)
photo_new_resource ( )

Generate a guaranteed unique photo ID.

Safe from birthday paradox.

Returns
string a uniqe hash

Referenced by import_channel_photo(), import_profile_photo(), and photo_upload().

preg_heart (   $x)
prepare_body ( $item,
  $attach = false 
)
profiler (   $t1,
  $t2,
  $label 
)
purify_html (   $s)
qp (   $s)
reltoabs (   $text,
  $base 
)

Referenced by get_atom_elements().

replace_macros (   $s,
  $r 
)

This is our template processor

Parameters
string | FriendicaSmarty$sthe string requiring macro substitution, or an instance of FriendicaSmarty
array$rkey value pairs (search => replace)
Returns
string substituted string

Referenced by achievements_content(), admin_content(), admin_page_channels(), admin_page_dbsync(), admin_page_hubloc(), admin_page_logs(), admin_page_plugins(), admin_page_profs(), admin_page_site(), admin_page_summary(), admin_page_themes(), admin_page_users(), advanced_profile(), alt_pager(), api_apply_template(), api_content(), app_render(), appman_content(), apps_content(), apw_form(), blocks_content(), App\build_pagehead(), categories_widget(), channel_content(), chat_content(), check_config(), check_php(), common_content(), common_friends_visitor_widget(), connect_content(), connections_content(), connedit_content(), construct_page(), contact_block(), conversation(), delegate_content(), design_tools(), diaspora_send_followup(), diaspora_send_images(), diaspora_send_mail(), diaspora_send_relay(), diaspora_send_retraction(), diaspora_send_status(), diaspora_share(), diaspora_unshare(), dir_safe_mode(), dir_sort_links(), directory_content(), display_content(), editblock_content(), editlayout_content(), editpost_content(), editwebpage_content(), events_content(), fbrowser_content(), fileas_widget(), filer_content(), filestorage_content(), findpeople_widget(), format_categories(), format_filer(), RedMatrix\RedDAV\RedBrowser\generateDirectoryIndex(), get_birthdays(), Item\get_comment_box(), get_events(), get_feed_for(), group_content(), group_side(), help_content(), home_content(), hostxrd_init(), RedMatrix\RedDAV\RedBrowser\htmlActionsPanel(), identity_selector(), import_content(), invite_content(), lang_selector(), layouts_content(), locs_content(), login(), lostpass_content(), lostpass_post(), mail_content(), manage_content(), match_content(), menu_content(), menu_render(), message_content(), micropro(), mini_group_select(), mitem_content(), mood_content(), nav(), network_content(), new_channel_content(), notification(), notifications_content(), notify_content(), oembed_format_object(), oexchange_init(), opensearch_init(), p_init(), pagelist_widget(), pdledit_content(), photos_album_widget(), photos_content(), poco(), poke_content(), poll_content(), populate_acl(), profile_sidebar(), profiles_content(), rate_content(), ratings_content(), rbmark_content(), redbasic_form(), register_content(), removeaccount_content(), removeme_content(), rmagic_content(), rpost_content(), search(), search_content(), searchbox(), send_reg_approval_email(), send_verification_email(), setup_content(), setup_post(), sharedwithme_content(), siteinfo_content(), sources_content(), suggest_content(), theme_attachments(), thing_content(), uexport_content(), user_allow(), vcard_from_xchan(), verify_email_address(), viewconnections_content(), vote_content(), webpages_content(), widget_affinity(), widget_appselect(), widget_archive(), widget_bookmarkedchats(), widget_chatroom_list(), widget_filer(), widget_follow(), widget_mailmenu(), widget_notes(), widget_savedsearch(), widget_settings_menu(), widget_suggestedchats(), widget_suggestions(), writepages_widget(), and xrd_init().

return_bytes (   $size_str)
sanitise_acl ( $item)
search (   $s,
  $id = 'search-box',
  $url = '/search',
  $save = false 
)

Referenced by search_content().

searchbox (   $s,
  $id = 'search-box',
  $url = '/search',
  $save = false 
)

Referenced by widget_savedsearch().

smile_shield (   $m)
smile_unshield (   $m)
smilies (   $s,
  $sample = false 
)

Function: smilies

Description: Replaces text emoticons with graphical images

: string $s

Returns string

It is expected that this function will be called using HTML text. We will escape text between HTML pre and code blocks, and HTML attributes (such as urls) from being processed.

At a higher level, the bbcode [nosmile] tag can be used to prevent this function from being executed by the prepare_text() routine when preparing bbcode source for HTML display

Referenced by chatsvc_content(), mail_content(), message_content(), and smilies_content().

sslify (   $s)

sslify($s) Replace media element using http url with https to a local redirector if using https locally

Parameters
string$sLooks for HTML tags containing src elements that are http when we're viewing an https page Typically this throws an insecure content violation in the browser. So we redirect them to a local redirector which uses https and which redirects to the selected content
Returns
string

Referenced by prepare_body().

stringify_array_elms ( $arr,
  $escape = false 
)
strip_zids (   $s)
tag_sort_length (   $a,
  $b 
)
theme_attachments ( $item)

Referenced by mail_content(), and prepare_body().

unamp (   $s)

Referenced by discover_by_webbie().

undo_post_tagging (   $s)
userReadableSize (   $size)

Returns a human readable formatted string for filesizes.

Parameters
int$sizefilesize in bytes
Returns
string

Referenced by RedMatrix\RedDAV\RedBrowser\generateDirectoryIndex(), and sharedwithme_content().

valid_email (   $x)
xchan_mail_query ( $item)

Referenced by notifier_run().

z_input_filter (   $channel_id,
  $s,
  $type = 'text/bbcode' 
)
zidify_callback (   $match)

zidify_callback() and zidify_links() work together to turn any HTML a tags with class="zrl" into zid links These will typically be generated by a bbcode '[zrl]' tag. This is done inside prepare_text() rather than bbcode() because the latter is used for general purpose conversions and the former is used only when preparing text for immediate display.

Issues: Currently the order of HTML parameters in the text is somewhat rigid and inflexible. We assume it looks like and will not work if zrl and href appear in a different order.

zidify_img_callback (   $match)
zidify_links (   $s)

Referenced by notification().

Variable Documentation

const RANDOM_STRING_HEX 0x00
const RANDOM_STRING_TEXT 0x01

Referenced by aes_encapsulate(), and random_string().