PHP.ug-Blog

Introducing API-Documentation

2016-03-09T00:00:00+00:00

After a recent debate on twitter and a lot of requests during the last months I finally took the time to do some documentation of the already available features of the API available at php.ug

You can find it right here at these github-pages

Now head over, have a look and play around. If you find issues, feel free to report them in the issue-tracker.

I will also at some point add a dedicated API with more funtionality, but that is something for another post ;)

Any questions? Feel free to contact us via our contact-form

List of usergroup-events

2015-01-01T00:00:00+00:00

Some people asked whether it would be possible to get a list of usergroup-events.

And here it is: Head over to php.ug/api/v1/calendar/list and have a look at all the events that are going to take place from now on.

You can also add this URL to your local calendaring-application and will always have an up-to-date calendar of all the usergroup-events we know of.

Depending on your Accept-Header you can get that list as HTML, iCalendar or JSON-version.

And as it is somewhat confusing when viewed as HTML-List we’ve also created a nice little calendar overview for you at php.ug/feature/calendar. It not only shows the known usergroup events but also gives an overview of PHP-related events on joind.in. That, of course, requires these events to be tagged with php.

So what usergroup-events are listed? Glad you asked. Every usergroup can add a link to an iCalendar-file for their event-calendar. All we do here is to aggregate the contents of these calendars into one calendar. So when your usergroups events aren’t listed here, chances are great, that there is no link to an iCalendar-file associated with your usergroup. Fix that and your events will be listed within the next 245 hours. Why not immediately? Well, we are doing some caching in the background and that cache will be updated every 24 hours, so thanks for being patient.

Any questions? Feel free to contact us via our contact-form

PHP-Events via joind.in-API

2014-07-01T00:00:00+00:00

Until a recent update to the joind.in-API a lot of non-PHP related events have been shown on the php.ug-Map. To get the focus onto the relevant events we have “joined forces” and added a filtering mechanism to the joind.in-API that now allows to filter events by tags.

Therefore the events you can now see on the PHP.ug-Map are 100% PHP-related!

Which brings us to another story: Your event will only be shown on the map when it is tagged php! So remember to set the tags for your event!

Any questions? Feel free to contact us via our contact-form

Center the map on any reference point

2014-06-03T00:00:00+00:00

So there is a lot of information hidden on the map at php.ug.

There are three different layers hidden in the select-field on the lower left corner. It allows you to see

all the PHP-Usergroups currently registered for the map
all events that are marked as upcomming on joind.in and
all the people currently taking aprentices or seeking mentors that are listed at phpmentoring.org.

But that’s rather a lot of stuff on the map. And perhaps you want to directly link to your entry.

Here is how you do it.

Usergroups

You did provide a shortname for your usergroup when you promoted it. You can use that shortname to center the map to your groups location by calling http://php.ug?center=<yourShortName>. Easy as that.

Events

Your event has an ID on joind.in which is used for identifying your event. So all you have to do is call http://php.ug?center=<YourEventsJoindInId>#joindin and you are ready to go.

PHPMentoring

You had to provide a github-account when you registered to PHPMentoring. (By the way: the location you provided there is what we take to get your geographic position. So if you fell you are in the wrong place, consider changing that location) That github-account can be used to center the map around your area. So you’ll have to call http://php.ug/center=<YourGithubAccount>#phpmentoring to get your part of the map.

Any questions? Feel free to contact us via our contact-form

Find PHPmentoring on the map

2014-05-19T00:00:00+00:00

Today we introduced a PHPMentoring-Layer at php.ug.

For that we parse the PHPMentoring-site and retrieve a geolocation based on the location everyone has provided in their github-account. Therefore some locations might be a bit off somehow, as the service used to find a geolocation can not resolve everything. There might be locations as moon or /dev/null that will not result in a correct geolocation and might therefore be somewhat displaced or not shown at all.

Also some places are ambiguous and as the process of getting geolocations is an automated one not always the right place is chosen.

But for most of the mentors and apprentices it works out quite well.

If you want to know more about the process of getting geolocations like that, drop me a line.