Template installation code uses rename() call internally, that fails when source and destination paths are not on the same filesystem.
There are few options how to solve it:
- Use temporary directory under template directory path (and mention that in the documentation explicitly), so
rename() never fails.
- Just mention that explicitly in the documentation and do nothing.
- Implement fallback to copy & unlink if rename() fails.