Wordpress社区似乎真的很喜欢这种PHP和HTML的混合，正如您所说的，这通常会导致很难理解和维护代码。

将“逻辑”和“表示”分开是一种常见的编程模式。这里的逻辑是决策的PHP代码，表示是HTML。

我强烈建议尽可能将两者分开，并在一个位置放置尽可能多的PHP，在另一个位置放置尽可能多的HTML。

例如，您可能有：

<b>Your name: <?php if user_logged_in() { $name=get_user_name(); echo $name; }  else { echo "please log in!"; } ?></b>

要将其分开，您可以写：

<?php 
      if (user_logged_in()) {
            $name = get_user_name();
       } else { 
            $name = "please log in!";
       }
?>

<b>Your name: <?php echo $name ; ?></b>

这种方法允许您开始将所有PHP和“业务逻辑”从HTML和“表示”中移开，以便您可以改变事物工作方式的逻辑，使其与表示方式分开。

我希望这有帮助！还有一些更高级的解决方案，比如PHP模板引擎，它们可以更好地进行分离，但这可能有些过头了。