Pr/3098

I've fixed up https://github.com/silverstripe/silverstripe-framework/pull/3098, rebased it, squashed the commits, fixed the test cases, and made a few API suggestions.
No, because the parameter doesn't exist in the current version for that method, it was added in this pull request :)