PIM-2696: Refactoring on WidgetRepository

| Q                    | A
| -------------------- | ---
| Bug fix?             | N
| New feature?         | N
| BC breaks?           | Y
| CI currently passes? | Y
| Tests pass?          | Y
| Scenarios pass?      | ?
| Checkstyle issues?   | N
| Changelog updated?   | Y
| Fixed tickets        |
| Doc PR               |
just a phpdoc to add 
![t0xhtgj](https://cloud.githubusercontent.com/assets/2104359/3329793/4449a980-f7ca-11e3-97bb-aa9ee9094f5c.gif)