The creation of social sets & custom social share links is remmarkably simple, with a few hits of your keyboard and a few mouse clicks you'll be well on your way.
We will start by going to the create a set page. Todo this you can follow the instructions in the image below or click here
Once we are on the page we will be greeted by this form
Regardless to whether you are making a set of share links or a set of profile links the beginning process is exactly the same. The first two fields wont change at all but the second two will. So lets talk about the first two fields, the first of the two is Title and the second Handle
The identifier for each set in a human readable form (Required)
This is the identier that socializr uses to fetch the set. this is not required as if it is left blank then socializr will pre-populate it with a safe version of the title.
Now that we have got the first two forms out of the way its time to finish off our set. Since there are two types of sets they are split up into sections, to see the step two for shares or step two for profiles you can click here and here, respectively.
In the previous section we covered the basics for creating either type of social set. But this time we are going to go into specific detail on how to create a Sharing link set. If you haven't read the previous part then I suggest you go back and do so.
We are going to be looking into the other two fields in this section.
The first is to select the type of field, so since Share is already selected it means we can leave this alone. But the other is a rather strange select box containing some social networks. To select a network just click on the required one, but to select multiple there is a few ways to do it. If you want to select a block of the you can click and drag over the required ones or you can cmd + click or ctrl + click depending on whether you are on mac or windows, respectively.
So once all the Fields are selected hit the good ol' save button and you're good to go. Once you hit save you should be greeted by this nice alert saying that it was successful.
If you have completed this then you can move onto including your social set on templates or in posts
When creating a set you will start off with 4 fields. The first two we already covered (title and handle) which leaves us with two more, Type and Shares. We can disregard Shares as it isnt relevant and focus on Type. So currently the type box contains the word Share well click it and select Profiles like so:
The Shares section should disappear and be replaced with this section here
Lets explain the fields:
The identifier for each set in a human readable form (Required)
This is the identier that socializr returns when fetching profiles from a set. this is not required as if it is left blank then socializr will pre-populate it with a safe version of the name.
This is the link for your profile. (Required)
Along with this fields come these two buttons:
The first is to remove that current row and the second is to add a new row underneath the current one.
So the nexxt step is to fill in all the fields and hit the save button. Once submitted you should see an alert at the top of the screen saying it was successful, if not then the errors should be reported to you.
If you have completed this then you can move onto including your social set on templates or in posts
An introduction to sharing links, by default Socializr adds Facebook, Twitter, Google+, LinkedIn & Reddit these 5 are undeletable. To add custom links you click the add new button on the index page or click Shares in the menu sidebar like so:
Upon clicking either of the links you will be greeted by a fairly simple form like so
Lets explain what these fields are:
The identifier for each share in a human readable form (Required)
This is the identier that socializr uses identify the share and returns it as an index when returning the set as an array. This is not required as if it is left blank then socializr will pre-populate it with a safe version of the title.
{% raw %}{% endraw %}This is where you put the link for sharing the way each provider needs it formatting for example
https://pinterest.com/pin/create/button/?url={{ current_url }}&description={{ current_title }}
Lets break down the pinterest example url. As you can see it has some weird tags in the url. these will be replaces with specific values (theyre explained on the form) once everything is filled in you can hit save and like the rest, you will be able to see a success message if it was successful. Like so:
To edit a set you click on a title of your desired set Like so
The form is exactly the same apart from its populated with your current data and has a delete link at the bottom
Once you have modified it then just hit Submit and it will save your new preferences.
To delete a set you click on a title of your desired set Like so
then hit the delete button:
You will be taken to this screen
Then just hit the yes button.
Poof! the set has now been deleted.
To edit a share you click on a title of your desired share Like so
The form is exactly the same apart from its populated with your current data and has a delete link at the bottom
Once you have modified it then just hit Submit and it will save your new preferences.
To delete a share you click on a title of your desired share Like so
then hit the delete button:
You will be taken to this screen
Then just hit the yes button.
Poof! the share has now been deleted.
There is a few ways you can use Socializr in your wordpress install whether you're a dev or just a writer. It doesnt matter as there is a few ways, you can use the shortcode (this can be put in the content section of a post/page) This is how you do it:
[socializr handle="put-your-handle-here"]
Remember to replace put-your-handle-here with the handle of your social set
Or if you have access to the template then you can do these functions (this can enable custom styling).
<?php echo socializr('your-handle', true); ?>
This would echo out each link into a list item
or if you would like to just return the values in an array you can do this
<?php $values = socializr('your-handle'); ?>
This would just return an array of your profiles/shares (each item in the array is an object and has the properties of title and link these could be accessed like so
<?php
$links = socializr('your-handle');
foreach ($links as $key => $link) {
echo $link->title;
echo $link->url;
}