[Feature] Different rules per locale

[Woeler]

Hello,

first time pull-requester here in the environment of Spatie. I'm hoping to get a feature in that I personally could use in one of my projects.

So, we have various translatable models, and of course our editors work in a Nova panel to edit and create them. The particular case we have is about news articles. The main language of our website is English, but we also publish in German and French.

In our workflow, an author will get to work writing and Article in English, and then publish it. After that is done he or she will begin translating the article to the other languages.

Currently we do not use any rules on our fields for news articles, because if we would set the title to required, it would require a title in English, German and French. But we only want the English title to be required, and the translations optional.

This pull request aims to solve this problem.

It contains six new public methods that can be called on the Translatable fields:

rules(array $rules)
The rules method will take a nested array of field names, which then in turn contain a key-value pair of a locale and its rules. For example:

$translatable->rules(['title' => ['en' => 'required']])

rulesFor(string $field, string $locale, $rules)
A more dynamic method to declare rules per field. A syntax I personally find a little more elegant and readable. It achieves the same behaviour like so:

$translatable->rulesFor('title', 'en', 'required');

In addition to those two, there are also methods for creation rules and update rules.

Of course, all methods work with all three types of Laravel rules declaration (string, array and Rule classes).

That's it from me. Any feedback is greatly appreciated.

Resolves: #64

[Woeler]

Hello again, can I perhaps have a reply on this, if this is a feature with merge potential?

[freekmurze]

Very nice, could you also update the readme with an example on how to use this?

[Woeler]

@freekmurze Absolutely. I'll do it tomorrow, after Easter is over. Cheers!

[Woeler]

@freekmurze I added it. I also added the composer test command which was referenced in the readme, but not available. Could you approve the workflow on this PR so the tests can run? Thanks.

[Woeler]

Rebased with main

[freekmurze]

The tests fail because of Nova installation issues, but I'm willing to merge already if you already tested in manually and can confirm that it works as intended.

[Woeler]

Hey, yes the tests run just fine locally. I have been using this functionality myself for quite some time already by extending the original Translatable class.

[freekmurze]

Thank you!