A free points management plugin for WordPress.
myCRED Logo
myCRED Logo
  • Membership New
  • Chapters
    • Chapter I – Introduction
    • Chapter II – Getting Started
    • Chapter III – Add-ons
    • Chapter IV – Premium Add-ons
    • Chapter V – For Developers
    • Chapter VI – Reference Guides
  • Categories
    • Actions
    • Classes
    • Constants
    • Filters
    • Functions
    • Objects
    • Shortcodes
    • Hooks
    • Template Tags
  • Packages
    • mycred/api
    • mycred/badge
    • mycred/balance
    • mycred/banking
    • mycred/content
    • mycred/core
    • mycred/coupon
    • mycred/email
    • mycred/game
    • mycred/log
    • mycred/notice
    • mycred/payment
    • mycred/purchase
    • mycred/rank
    • mycred/transfer
  • Store
  • Download
    Navigation
    • Loading navigation ...
    All Shortcodes
    myCRED shortcodes
    1. mycred_affiliate_id
    2. mycred_affiliate_link
    3. mycred_all_scratch_cards
    4. mycred_badges
    5. mycred_badges_progress
    6. mycred_best_user
    7. mycred_buy
    8. mycred_buy_form
    9. mycred_buy_pending
    10. mycred_chart_balance_history
    11. mycred_chart_circulation
    12. mycred_chart_gain_loss
    13. mycred_chart_history
    14. mycred_chart_instance_history
    15. mycred_chart_top_balances
    16. mycred_chart_top_instances
    17. mycred_content_buyer_avatars
    18. mycred_content_buyer_count
    19. mycred_content_sale_count
    20. mycred_email_subscriptions
    21. mycred_exchange
    22. mycred_give
    23. mycred_hide_if
    24. mycred_history
    25. mycred_hook_table
    26. mycred_leaderboard
    27. mycred_link
    28. mycred_list_ranks
    29. mycred_load_coupon
    30. mycred_lotteries
    31. mycred_lottery
    32. mycred_lottery_jackpot
    33. mycred_lottery_quickpick
    34. mycred_lottery_results
    35. mycred_lottery_winnings
    36. mycred_my_badges
    37. mycred_my_balance
    38. mycred_my_balance_converted
    39. mycred_my_rank
    40. mycred_my_ranking
    41. mycred_my_ranks
    42. mycred_my_ranks_progress
    43. mycred_my_transfer_fee
    44. mycred_paymentwall
    45. mycred_pending_transfers
    46. mycred_rank_progress
    47. mycred_sales_history
    48. mycred_scratch_cards
    49. mycred_scratch_cards_remaining
    50. mycred_scratch_history
    51. mycred_sell_this
    52. mycred_sell_this_ajax
    53. mycred_send
    54. mycred_show_if
    55. mycred_stripe_buy
    56. mycred_stripe_subscribe
    57. mycred_stripe_subscription
    58. mycred_total_balance
    59. mycred_total_points
    60. mycred_total_since
    61. mycred_transfer
    62. mycred_users_of_all_ranks
    63. mycred_users_of_rank
    64. mycred_video
    Categories
    Filter by category
    1. Actions
    2. Classes
    3. Filters
    4. Functions
    5. Hooks
    6. Objects
    7. Shortcodes
    8. Template Tags
    Chapters
    Documentation
    1. Chapter I - Introduction
    2. Chapter II - Getting Started
    3. Chapter III - Add-ons
    4. Chapter IV - Premium Add-ons
    5. Chapter V - For Developers
    6. Chapter VI - Reference Guides
mycred_link

Codex / mycred/core / Shortcodes / mycred_link

Description

This shortcode allows you to award or deduct points from the current user when their click on a link. This shortcode will always generate a link, even if the user viewing it has already clicked on it / reached their limit or if the shortcode is viewed by a user that is logged out. However no points will be paid out unless the user is logged in, are not excluded and have not yet reached the limit you might have set for the “Points for clicking on links” hook.

If you do not set a point amount to award in the shortcode, the amount you set in the hook will be paid out instead.

You can set a limit for how many times a user can gain points for clicking on each individual link. This can either be enforced using the URL you set for the link or using an ID. If you set to enforce a limit using an ID and you do not set an ID in your shortcode, the hook will convert the URL into an ID.

This shortcode uses AJAX to award points. This means that a link will not redirect a user to the targeted URL until the AJAX handler has responded with a result. This in turn can on some sites results in a slight delay from the moment you click on the link until your browser starts loading the URL. This of course only occurs if you do not use the target attribute.

Requires the “Points for clicking on links” hook to be enabled.

Available since version 1.1

Shortcode Attributes
Attribute Type Required Default Description
href string Yes - The URL the link leads to.
amount int or float No - The amount of points to give users to clicking on the link. If not set, the amount you set in the hook will be awarded.
ctype string No mycred_default The point type to give users. Should not be used if you only have one point type installed.
id string No - Option to set the ID attribute for the anchor.
rel string No - Option to set the ref attribute for the anchor.
class string No - Option to set the class attribute for the anchor.
title string No - Option to set the title attribute for the anchor.
target string No - Option to set the target attribute for the anchor.
style string No - Option to set the style attribute for the anchor.
hreflang string No - Option to set hreflang attribute for the anchor.
media string No - Option to set the media attribute for the anchor.
type string No - Option to set the type attribute for the anchor.
onclick string No - Option to set the onclick attribute for the anchor.

You can only give points to users in the point types you have enabled. If you have a custom point type where the “Points for clicking on links” is not enabled, the user will not receive this type of points.

CSS Styling
a.mycred-points-link { }
Examples

Example 1: Give 1 point for clicking on a link.

[mycred_link amount=1 href="http://www.mycred.me" target="_blank"]View portfolio[/mycred_link]

Example 2: Give 10 custom point type “coins” for clicking on a link.

[mycred_link amount="10.000" href="http://www.mycred.me" target="_blank" ctype="coins"]View portfolio[/mycred_link]

Example 3: Give users points based on your hook settings.

[mycred_link href="http://www.mycred.me"]View portfolio[/mycred_link]
0

About myCred

myCred is a free, open-source and developer friendly points management tool for WordPress powered websites.

Download Rate Plugin

Documentation

  • Add-ons
  • Core Shortcodes
  • F.A.Q.
  • Tutorials
  • Third Party Plugins
  • Code Snippets

Support

  • Product Licenses
  • Customization
  • Support Forums
  • Plugin Changelog
  • Contact

Copyright 2013 - 2021 by WPExperts; All rights reserved. myCred is licensed under GPL 2.0

Terms & Conditions • Use of Cookies • Store Policy • Community Rules

Suggest Codex Example

You can submit suggestions for codex examples that you have available as a public gist. If you are a member on the mycred.me website, you can earn Tokens for each submission. To claim these Tokens, make sure you provide your mycred.me username.

Please make sure the example you submit is relevant and if you include documentation, it's provided in English.

logo
  • Membership New
  • Chapters
    • Chapter I – Introduction
    • Chapter II – Getting Started
    • Chapter III – Add-ons
    • Chapter IV – Premium Add-ons
    • Chapter V – For Developers
    • Chapter VI – Reference Guides
  • Categories
    • Actions
    • Classes
    • Constants
    • Filters
    • Functions
    • Objects
    • Shortcodes
    • Hooks
    • Template Tags
  • Packages
    • mycred/api
    • mycred/badge
    • mycred/balance
    • mycred/banking
    • mycred/content
    • mycred/core
    • mycred/coupon
    • mycred/email
    • mycred/game
    • mycred/log
    • mycred/notice
    • mycred/payment
    • mycred/purchase
    • mycred/rank
    • mycred/transfer
  • Store
  • Download