Affluent Americans seeking affordability and quality abroad are turning to overlooked small towns in Portugal, France, Greece, Belize, and Costa Rica.